Skills for AI agents
The CLI is for humans and CI. Skills are for agents. Eleven /straymark-* slash-commands ship with the framework so Claude Code, Gemini CLI, Copilot CLI and others can invoke Charter scaffolding, AILOG creation, audit cycles, status checks and security assessments without you having to dictate the steps.
Why this matters
- Rituals you have to dictate are rituals nobody performs. A team that says "remember to write an AILOG before committing" produces zero AILOGs after week two. Skills make the rituals discoverable from inside the agent:
/straymark-statusshows where the team is,/straymark-charter-newscaffolds the right document type with prompts for scope. - One source of truth for both manual and agent flows. The CLI command
straymark new -t AILOGand the skill/straymark-ailogproduce the same document; only the entry point differs. Maintainers don't keep two implementations in sync. - New rituals ship as new skills. When the framework adds a new ritual (e.g. the three-skill audit cycle), it ships as new slash commands the agent discovers after
straymark update-framework. No retraining.
The eleven skills
| Skill | Purpose |
|---|---|
/straymark-status | Documentation status & compliance check |
/straymark-new | Create any StrayMark document type (interactive) |
/straymark-charter-new | Scaffold a Charter — the bounded unit of work |
/straymark-ailog | Quick AILOG creation for the current commit |
/straymark-aidec | Record a standalone decision with alternatives & trade-offs |
/straymark-adr | Create an Architecture Decision Record |
/straymark-mcard | Model Card (interactive multi-step flow) |
/straymark-sec | Security Assessment (interactive, OWASP ASVS-aware) |
/straymark-audit-prompt CHARTER-XX | Generate the multi-model audit prompt |
/straymark-audit-execute [CHARTER-XX] | Run an audit inside an auditor-side CLI |
/straymark-audit-review CHARTER-XX | Consolidate audit reports into a calibrated review |
How they fit together
The agent calls /straymark-status to see what's missing. It scaffolds a Charter with /straymark-charter-new, declares scope and risks, ships the work, runs /straymark-ailog to log execution, and /straymark-audit-prompt to commission an external audit. Each skill is small; the discipline emerges from their composition.