@agimon-ai/po-skill 0.0.0-alpha.0

package/dist/skills-Ccvg1Hcz.mjs

@@ -0,0 +1,8 @@
+//#region src/types/skills.ts
+const SKILLS_COMMAND = "skills";
+const SKILL_INVOCATION_PREFIX = "/skill:";
+const SKILL_COMMAND_PREFIX = "skill:";
+//#endregion
+export { SKILL_COMMAND_PREFIX as n, SKILL_INVOCATION_PREFIX as r, SKILLS_COMMAND as t };
+
+//# sourceMappingURL=skills-Ccvg1Hcz.mjs.map

package/dist/skills-Ccvg1Hcz.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-Ccvg1Hcz.mjs","names":[],"sources":["../src/types/skills.ts"],"sourcesContent":["export const SKILLS_COMMAND = 'skills';\nexport const SKILL_INVOCATION_PREFIX = '/skill:';\nexport const SKILL_COMMAND_PREFIX = 'skill:';\n"],"mappings":";AAAA,MAAa,iBAAiB;AAC9B,MAAa,0BAA0B;AACvC,MAAa,uBAAuB"}

package/dist/skills-ComtgYb1.cjs

@@ -0,0 +1,25 @@
+//#region src/types/skills.ts
+const SKILLS_COMMAND = "skills";
+const SKILL_INVOCATION_PREFIX = "/skill:";
+const SKILL_COMMAND_PREFIX = "skill:";
+//#endregion
+Object.defineProperty(exports, "SKILLS_COMMAND", {
+	enumerable: true,
+	get: function() {
+		return SKILLS_COMMAND;
+	}
+});
+Object.defineProperty(exports, "SKILL_COMMAND_PREFIX", {
+	enumerable: true,
+	get: function() {
+		return SKILL_COMMAND_PREFIX;
+	}
+});
+Object.defineProperty(exports, "SKILL_INVOCATION_PREFIX", {
+	enumerable: true,
+	get: function() {
+		return SKILL_INVOCATION_PREFIX;
+	}
+});
+
+//# sourceMappingURL=skills-ComtgYb1.cjs.map

package/dist/skills-ComtgYb1.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-ComtgYb1.cjs","names":[],"sources":["../src/types/skills.ts"],"sourcesContent":["export const SKILLS_COMMAND = 'skills';\nexport const SKILL_INVOCATION_PREFIX = '/skill:';\nexport const SKILL_COMMAND_PREFIX = 'skill:';\n"],"mappings":";AAAA,MAAa,iBAAiB;AAC9B,MAAa,0BAA0B;AACvC,MAAa,uBAAuB"}

package/llms.txt

@@ -0,0 +1,15 @@
+# Doom Pi Skill
+
+The session skill catalogue, deferred skill discovery, and the `SPC e s` browser.
+
+## How to author
+
+- [Author Po skills](./src/prompts/po-author-skill/SKILL.md): Create, distribute, and register runtime skills or activation-gated Help prompts.
+
+## How to use
+
+- [Use Po skills](./src/prompts/po-use-skill/SKILL.md): Browse the catalog, invoke deferred skills, and diagnose missing or shadowed skills.
+
+## Package reference
+
+- [Package README](./README.md): The `/skills` command, deferred discovery, and extension-contributed skill directories.

package/package.json

@@ -0,0 +1,135 @@
+{
+  "name": "@agimon-ai/po-skill",
+  "version": "0.0.0-alpha.0",
+  "description": "Session skill catalogue, deferred skill discovery, and the skill browser for Po.",
+  "keywords": [
+    "agent-skills",
+    "ai",
+    "coding-agent",
+    "developer-tools",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package",
+    "po",
+    "skill-catalog",
+    "skill-discovery"
+  ],
+  "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/po/issues"
+  },
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/po.git",
+    "directory": "packages/foundations/po-skill"
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "README.md",
+    "src/prompts",
+    "LICENSE",
+    "package.json"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./apiContracts": {
+      "types": "./dist/apiContracts.d.mts",
+      "import": "./dist/apiContracts.mjs",
+      "require": "./dist/apiContracts.cjs"
+    },
+    "./catalog": {
+      "types": "./dist/catalog.d.mts",
+      "import": "./dist/catalog.mjs",
+      "require": "./dist/catalog.cjs"
+    },
+    "./extensions/server": {
+      "types": "./dist/extensions/server.d.mts",
+      "import": "./dist/extensions/server.mjs",
+      "require": "./dist/extensions/server.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agimon-ai/po-config": "0.0.0-alpha.0",
+    "@agimon-ai/po-core": "0.0.0-alpha.0",
+    "@agimon-ai/po-domain": "0.0.0-alpha.0",
+    "@agimon-ai/po-telemetry": "0.0.0-alpha.0",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.0",
+    "@deepseek-ai/cordis": "4.0.4",
+    "gpt-tokenizer": "4.0.0",
+    "typebox": "1.3.34"
+  },
+  "devDependencies": {
+    "@agimon-ai/po-build": "0.0.0-alpha.0",
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.0-alpha.0",
+    "@deepseek-ai/cordis": "4.0.4",
+    "@earendil-works/pi-coding-agent": "1.0.2",
+    "@types/node": "26.6.4",
+    "@types/react": "19.3.0",
+    "@vitest/coverage-v8": "5.0.3",
+    "react": "19.3.0",
+    "tsdown": "0.23.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "1.0.2"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "poMcp": {
+    "entry": "./generated/mcp.ts",
+    "dist": "./dist/extensions/mcp.mjs",
+    "scopes": [
+      "session"
+    ],
+    "ui": {
+      "entry": "./generated/mcp-ui.ts",
+      "dist": "./dist/extensions/mcp-ui.mjs",
+      "widgets": [
+        "@agimon-ai/po-skill/load_skill",
+        "@agimon-ai/po-skill/search_skills"
+      ]
+    }
+  },
+  "poServer": {
+    "entry": "./generated/server.ts",
+    "dist": "./dist/extensions/server.mjs",
+    "scopes": [
+      "session"
+    ],
+    "contracts": {
+      "entry": "./src/exports/apiContracts.ts",
+      "dist": "./dist/apiContracts.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown && pnpm build:mcp",
+    "build:mcp": "tsdown --config tsdown.mcp.config.ts",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.mcp.json",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}

package/src/prompts/po-author-skill/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: po-author-skill
+description: Author and distribute Po agent skills. Use when creating a SKILL.md, adding supporting references or scripts, contributing a runtime skill directory through Cordis, or publishing activation-gated Help prompts from a Po package.
+---
+
+# Author Po skills
+
+Create one focused skill per directory. Name the directory with lowercase letters, digits, and hyphens, and give it a required `SKILL.md`:
+
+```markdown
+---
+name: repository-review
+description: Review repository changes when the user asks for implementation-risk and regression analysis.
+---
+
+# Repository review
+
+Put the essential workflow and non-obvious constraints here.
+```
+
+The frontmatter `name` must match the directory. Make the description specific enough for automatic routing. Keep the entrypoint concise, and put substantial conditional details in linked `references/`. Add `scripts/`, `assets/`, or `agents/` only when the skill actually uses them.
+
+## Choose the distribution path
+
+- For a normal Pi skill that should be discoverable whenever its owning extension is active, ship the skill under a package-owned runtime directory such as `skills/<name>/SKILL.md`. Register that directory through `DOOM_SKILL_SOURCES_SERVICE` inside an owning `cordis.inject(...)`, and return the contribution disposer.
+- For guidance that should appear only while Po Help is active, put it at `src/prompts/<name>/SKILL.md`, publish `src/prompts`, link it from the package's H1-led `llms.txt`, and register a Help descriptor through `DOOM_HELP_SERVICE`.
+- For repository content selected by domains, place the skill in the plugin or shared skill source configured by `domains.yaml`; do not hard-code that directory into the Skill package.
+
+Pi Help descriptors carry only `name` and `description`. The Help service resolves the owning package from the contribution's exact package `source` and `moduleUrl`, then wraps its `llms.txt`. Keep every index link inside the published package.
+
+On the server host, contribute the same Help skill through a named `resource/*.server.ts` route with `when: DOOM_HELP_WHEN` from `@agimon-ai/po-core/help`. Include its useful description and an absolute `path` resolved with `packageResourcePath(import.meta.url, ...)`; a reader alone does not make the skill discoverable in the agent prompt. Keep ordinary runtime skills under their existing conditions.
+
+Package-owned Help tools use ordinary named tool routes, not documentation descriptors. Server tools use the existing Help condition and execution guards. Pi tools also need `createPiHelpToolGate(packageName, toolNames)`: install its services and onStart in the owning root, then authorize each invocation with `gate.assertActive`. Portable `when` metadata alone does not enforce the Pi gate. The Help README and Log package's `diagnose_agent` contribution show the complete pattern. Bound diagnostics to the current session, omit secrets, and use existing approval mechanisms for repairs.
+
+## Verification
+
+Validate the skill frontmatter, ensure every relative reference resolves, and test the packed package rather than relying on checkout-only files. For Cordis contributions, cover late provider arrival, provider replacement, withdrawal, and package shutdown. Test the actual prompt and tool surface before activation, while active, and after deactivation; stale calls must be rejected without removing ordinary capabilities. Use `/skills` or `SPC e s` in an interactive session to confirm the expected owner and invocation name. Do not add remote MCP exposure merely because a local Help contribution exists.

package/src/prompts/po-use-skill/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: po-use-skill
+description: Use Po's skill catalog and deferred discovery. Use when browsing available skills, invoking /skill:name, understanding Help and extension-owned skill groups, or diagnosing why a skill is absent or shadowed.
+---
+
+# Use Po skills
+
+Open the skill browser with `/skills` or `SPC e s`. The catalog groups normal session skills, package Help skills, plugin skills, and extension-contributed directories by owner.
+
+Invoke a skill with `/skill:<name>`. Po expands deferred skills before Pi handles the input, so a skill can be invokable even when its full body was not placed in the initial prompt. Help skills appear only while Help mode is active.
+
+When a skill is missing:
+
+1. Confirm its owning package, plugin, domain, or Help mode is active.
+2. Wait for deferred discovery to finish by opening `/skills` or invoking the exact skill.
+3. Check the browser diagnostics for unreadable `SKILL.md` files, invalid frontmatter, duplicate names, or unavailable Help resources.
+4. If two sources use the same name, remember that normal loaded and deferred skills take precedence over Help skills.
+5. After changing domains or package composition, reload or relaunch as requested so the session receives the new skill directories.