Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/rolecraft-sh/rolecraft/initgit clone --depth 1 https://github.com/rolecraft-sh/rolecraftWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00000 | $0.00706 |
| Opus 5 | $0.00000 | $0.00353 |
| Sonnet 5 | $0.00000 | $0.00141 |
| Haiku 4.5 | $0.00000 | $0.00071 |
Grade A, and why
init scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 88 lines — stays where its author put it; the contents beside it link to each section on GitHub.
rolecraft init
Scaffold a new SKILL.md for your agent skill.
Usage
rolecraft init # create ./my-skill/SKILL.md (default: my-skill)
rolecraft init my-custom-tool # create ./my-custom-tool/SKILL.md
rolecraft init namespace/skill # create ./namespace-skill/SKILL.md
rolecraft init --list # list available templates
rolecraft init my-skill --template basic # scaffold from a template
rolecraft init my-skill --template react # scaffold with React best practices
Description
Generates a ready-to-edit SKILL.md with proper slug, name, and owner metadata. Edit it with your skill instructions, then install with rolecraft install <dir>.
Use --list to see all available templates. Use --template <name> to scaffold from a specific template that pre-fills sections, MCP server configuration, or agent targeting for common patterns.
Options
| Option | Description |
|---|---|
--list |
List all available templates with descriptions |
--template <name> |
Scaffold from a named template instead of the default |
Available templates
| Template | Description |
|---|---|
basic |
General-purpose skill template for AI agent instructions |
code-review |
Code review guidelines and best practices for AI agents |
git-workflow |
Git workflow conventions and branch strategy for AI agents |
testing |
Testing guidelines and best practices for AI agents |
security |
Security guidelines and dangerous pattern detection for AI agents |
react |
React best practices and component patterns for AI agents |
When no --template flag is provided, a minimal frontmatter scaffold is created (backward-compatible with older versions).
Examples
List available templates
rolecraft init --list
# Available templates:
# basic General-purpose skill template for AI agent instructions
# code-review Code review guidelines and best practices for AI agents
# git-workflow Git workflow conventions and branch strategy for AI agents
# testing Testing guidelines and best practices for AI agents
# security Security guidelines and dangerous pattern detection for AI agents
# react React best practices and component patterns for AI agents
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago First seen · 88 lines · 0 tokens per session scan A ceb96ca57c5b
init is a command published in the GitHub repository rolecraft-sh/rolecraft (75 stars, last pushed 5d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 706 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other commands, from other repositories
optimize
Optimize performance [target].
plan-infra
Confirm requirements with the user first, then design cloud infrastructure and write a reproducible spec + diagram into the repo.
takeoff
항공기 이륙 4단계 — develop 리베이스 → push → PR 생성 (원격 영향).
rclone_convmv
Convert file and directory names in place.
init
Generate FILETREE.md from scratch. Confirms overwrite if it already exists. --self-only keeps every artifact out of git.
rclone_copy
Copy files from source to dest, skipping identical files.