kyberforge: add prompt-author skill for .apm/prompts/*.prompt.md #149

Open
opened 2026-10-01 06:23:28 +00:00 by Claude · 0 comments
Collaborator

Part of #94.

Why

kyberforge has no author skill for .apm/prompts/*.prompt.md. Claude compile keeps only description, allowed-tools, model, argument-hint and arguments from a prompt's frontmatter; anything else is dropped silently.

What to build

A new prompt-author skill, shaped like agent-author:

  • SKILL.md with a trigger description that states its domain boundary (ADR-0021) and routes review-only requests to factory-audit and skills/agents to their own author skills.
  • assets/templates/ with a minimal valid prompt file.
  • references/ covering which fields survive compile per target. Source: plugins/kyberforge/docs/research/docs/microsoft-apm/prompt-primitive-schema.md. Cite it through source_keys and references/sources.md.
  • scripts/new-prompt.sh scaffolder and tests/new-prompt.bats, following agent-author.
  • A one-line pointer to the new skill in apm-workflow's compile reference (references/compile.md).
  • A row in forge/SKILL.md's routing table.

Not in scope

  • Auditing prompt files. That is the audit issue for prompts, which depends on this one.
  • A separate gotchas copy in apm-workflow. This skill owns them.

Acceptance criteria

  • plugins/kyberforge/.apm/skills/prompt-author/ exists with SKILL.md, assets/, references/, scripts/, tests/.
  • Scaffolded output passes apm compile for the Claude target and the five surviving fields are demonstrated in a test or fixture.
  • metadata.version set per ADR-0022; description and body pass ADR-0020 budgets (scripts/skill-size-check.sh).
  • forge/SKILL.md has a route to it; apm-workflow/references/compile.md points to it.
  • factory-audit run on the new skill returns PASS.
  • apm audit --ci clean; bats tests pass.

References

  • plugins/kyberforge/docs/research/docs/microsoft-apm/prompt-primitive-schema.md
  • plugins/kyberforge/.apm/skills/agent-author/ as the structural model
  • ADR-0020, ADR-0021, ADR-0022
Part of #94. ## Why kyberforge has no author skill for `.apm/prompts/*.prompt.md`. Claude compile keeps only `description`, `allowed-tools`, `model`, `argument-hint` and `arguments` from a prompt's frontmatter; anything else is dropped silently. ## What to build A new `prompt-author` skill, shaped like `agent-author`: - `SKILL.md` with a trigger description that states its domain boundary (ADR-0021) and routes review-only requests to `factory-audit` and skills/agents to their own author skills. - `assets/templates/` with a minimal valid prompt file. - `references/` covering which fields survive compile per target. Source: `plugins/kyberforge/docs/research/docs/microsoft-apm/prompt-primitive-schema.md`. Cite it through `source_keys` and `references/sources.md`. - `scripts/new-prompt.sh` scaffolder and `tests/new-prompt.bats`, following `agent-author`. - A one-line pointer to the new skill in `apm-workflow`'s compile reference (`references/compile.md`). - A row in `forge/SKILL.md`'s routing table. ## Not in scope - Auditing prompt files. That is the audit issue for prompts, which depends on this one. - A separate gotchas copy in `apm-workflow`. This skill owns them. ## Acceptance criteria - [ ] `plugins/kyberforge/.apm/skills/prompt-author/` exists with `SKILL.md`, `assets/`, `references/`, `scripts/`, `tests/`. - [ ] Scaffolded output passes `apm compile` for the Claude target and the five surviving fields are demonstrated in a test or fixture. - [ ] `metadata.version` set per ADR-0022; description and body pass ADR-0020 budgets (`scripts/skill-size-check.sh`). - [ ] `forge/SKILL.md` has a route to it; `apm-workflow/references/compile.md` points to it. - [ ] `factory-audit` run on the new skill returns PASS. - [ ] `apm audit --ci` clean; bats tests pass. ## References - `plugins/kyberforge/docs/research/docs/microsoft-apm/prompt-primitive-schema.md` - `plugins/kyberforge/.apm/skills/agent-author/` as the structural model - ADR-0020, ADR-0021, ADR-0022
Claude added this to the Kyberforge basics milestone 2026-10-01 06:23:28 +00:00
Claude added the Kind/Feature label 2026-10-01 06:23:28 +00:00
Sign in to join this conversation.