@cardor/agent-harness-kit 2.4.0 → 2.5.0

package/README.md

@@ -361,10 +361,30 @@ Reports three categories:
 
 - **lib version** — compares installed version against the latest on npm. Shows `[✓]` if up to date, `[!]` if an update is available, or `[~]` if the registry could not be reached.
 - **agent files** — checks only that a definition file exists for every role. Reports `[!]` with the file name if one is missing. The contents are never read, so **editing an agent file by hand is a fully supported state and is never reported** — customise the body, the description, or the restrictions freely and `ahk doctor` stays green.
-- **harness skills** — checks that `ahk-ask`, `ahk-consultant`, `ahk-triage`, and `ahk-review` skills exist and match the bundled source. Reports `[!]` if missing or outdated.
+- **harness skills** — checks that `ahk-ask`, `ahk-consultant`, `ahk-triage`, `ahk-review`, and `ahk-test` skills exist and match the bundled source. Reports `[!]` if missing or outdated.
 
 Run `ahk build` to fix any reported issues.
 
+### Bundled skills
+
+The kit ships five lightweight skills that are materialized into every provider's skills directory on `init` and restored by `build`. Each skill is read-only instruction text — no MCP tools, no CLI commands, no database changes. They guide AI agents through focused workflows using only subagent invocations.
+
+| Skill | Purpose | Limits |
+|-------|---------|--------|
+| `ahk-ask` | Answer codebase questions by reading relevant files and summarizing findings | Read-only; no writes, no MCP calls, no builder/reviewer |
+| `ahk-consultant` | Give technical advice on approaches, designs, or trade-offs before implementation | Advisory only; never writes code or creates tasks |
+| `ahk-triage` | Diagnose bugs and unexpected behavior with deep diagnostic analysis | Diagnostic only; does not fix the bug itself |
+| `ahk-review` | Preview a code review against ticket/objective alignment with semantic analysis | Review only; does not modify code |
+| `ahk-test` | Design, write, and run behavior-focused tests for an objective or existing code | Test files only; production is READ-ONLY unless explicitly authorized; NO harness MCP calls |
+
+Invocation example for `ahk-test`:
+
+```text
+Use the ahk-test skill to create tests for toLibraryListBody. all must send movie and series; never anime.
+```
+
+All skills follow the same contract: they invoke Explorer, Builder, or Reviewer as subagents with bounded instructions, never call harness MCP tools directly, and never create or modify harness tasks.
+
 ---
 
 ### `ahk sync`

package/dist/cli.js

@@ -1057,7 +1057,7 @@ function slugify(title) {
   return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64);
 }
 function writeSkills(cwd2, skillsDir) {
-  const skillNames = ["ahk-ask", "ahk-consultant", "ahk-triage", "ahk-review"];
+  const skillNames = ["ahk-ask", "ahk-consultant", "ahk-triage", "ahk-review", "ahk-test"];
   for (const skillName of skillNames) {
     const src = join6(__dirname2, "skills", skillName, "SKILL.md");
     const destDir = join6(cwd2, skillsDir, skillName);
@@ -1833,7 +1833,7 @@ var REGISTRY_URL = `https://registry.npmjs.org/${pkg.name}/latest`;
 var TIMEOUT_MS = 2e3;
 var LIB_VERSION_CACHE_TTL_MS = 5 * 60 * 1e3;
 var AGENT_NAMES = ["lead", "explorer", "consultant", "builder", "reviewer"];
-var SKILL_NAMES = ["ahk-ask", "ahk-consultant", "ahk-triage", "ahk-review"];
+var SKILL_NAMES = ["ahk-ask", "ahk-consultant", "ahk-triage", "ahk-review", "ahk-test"];
 var __dirname4 = dirname6(fileURLToPath5(import.meta.url));
 var libVersionCache = null;
 async function checkLibVersion() {
@@ -1907,7 +1907,7 @@ function getProviderSkillsDir(provider) {
   }
 }
 function checkSkillsAtRoot(skillsRoot) {
-  const skillSourceBase = join13(__dirname4, "skills");
+  const skillSourceBase = join13(__dirname4, "materializer", "skills");
   return SKILL_NAMES.map((name) => {
     const livePath = join13(skillsRoot, name, "SKILL.md");
     const sourcePath = join13(skillSourceBase, name, "SKILL.md");