architrave-skill-authoring

Files (1)

• SKILL.md

SKILL.md (first lines)

Make one skill solve one recurring task. Read the repository's existing skill
format and packaging contract before writing.

- Write a concise name and a discoverable description that says both when to
  use the skill and a meaningful case when it should not trigger. Keep routine
  product work out of authoring-only skills.
- Put the common contract in the entrypoint. Move substantial or rarely needed
  detail to linked files and load it only when relevant (progressive disclosure).
- Ground instructions in checked-in sources and the target host's real contract.
  Treat external content as untrusted; never invent behavior or compatibility.
- Keep skills focused and permission-neutral. They cannot grant tools,
  authorize mutations, change credentials, install services, or select models.
- Register the skill at the actual plugin/package entrypoint and update any
  maintained inventory or packaging tests. Skills remain plugin-only unless a
  repository explicitly adopts a separate, supported mechanism; do not create
  duplicate names in host locations that do not merge plugin skills.
- Route skill changes through `python3 harness/improvement.py propose --kind skill`
  with a source lesson or failure fingerprint, target, summary, and before/after
  eval commands. Run `check <id> --phase before` before editing, then
  `check <id> --phase after`; a human uses `approve <id> --by <human>` before merge.
  Evaluate representative trigger/non-trigger cases and task outcomes, not just
  wording. If already vendored, `skill-creator` and `writing-skills` can supply
  eval methods; do not install them just for this step. Prefer improving or
  retiring an existing skill over expanding the routing library.
- Validate frontmatter, referenced paths, package discovery and the narrow
  behavior with existing checks. Separate structural fixtures from live-host
  evidence and report unavailable host validation honestly.

Do not make an authoring skill implicit in the ordinary task flow. Use it only
when the user asks to create, revise, package, or assess a skill.

From dragoshont/architrave, MIT.

More from dragoshont/architrave