Files
holocron/plugins/kyberforge/.apm/skills/instructions-author/references/create.md
T
Defame1297andClaude Code c52e351954 feat(kyberforge): add instructions-author skill for .apm/instructions files
Scaffolds and revises apm instructions files, with a throwaway-package
verification recipe because `apm compile --validate` always exits 0 and
Claude Code drops `description`. Routed from forge and linked from
apm-workflow's compile reference. Bumps kyberforge to 2.1.0 and the catalog
to 0.5.2.

Fixes #148

Co-Authored-By: Claude Code <[email protected]>
Claude-Session: https://claude.ai/code/session_01KkT7RSDwDbmrM9T34b6sTi
2026-10-01 06:46:39 +00:00

1.5 KiB

source_keys
source_keys
apm-docs-site
apm-cli-0-28-0-experiments

Creating a new instructions file

Return to SKILL.md Step 3 once Step 3 below is done.

Before touching the filesystem

Confirm, and ask the user for anything missing:

  • The one topic the file covers. Two topics are two files.
  • Which files it governs, as a glob, or that it must load in every session.
  • A kebab-case stem. It becomes the deployed filename.

Step 1 — Check the stem

Install overwrites a hand-authored file at .claude/rules/<stem>.md, .cursor/rules/<stem>.mdc, .windsurf/rules/<stem>.md, .kiro/steering/<stem>.md and .agents/rules/<stem>.md without a prompt. List those paths in the consuming project and choose another stem on any hit.

Step 2 — Scaffold

bash scripts/new-instructions.sh <name> <path-inside-the-package>

The script walks up for a type:-bearing apm.yml. With none it exits 1 and names /apm-workflow configure; run that first, then retry. It never overwrites an existing file.

Step 3 — Fill in

Replace every FILL IN: and delete the template's comments.

  • applyTo: quoted. Omit it only for a rule that must load in every session, and say so to the user; it costs context at every launch.
  • description: one line. Write the body as if it were absent, because Claude Code never sees it.
  • Body: bullets, one topic, paths in backticks, nothing that assumes another file is loaded.

For glob syntax or a field question, read references/schema.md.