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 instructions/zakelfassi/skills-driven-development/claude-mdgit clone --depth 1 https://github.com/zakelfassi/skills-driven-developmentWhat 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.00500 | $0.00500 |
| Opus 5 | $0.00250 | $0.00250 |
| Sonnet 5 | $0.00100 | $0.00100 |
| Haiku 4.5 | $0.00050 | $0.00050 |
Grade A, and why
skills-driven-development CLAUDE.md 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.
What it actually says
SkDD — agent instructions
Active goal
The current build goal is docs/plans/2026-07-skdd-commons.md — SkDD Commons + the July 2026 Frontier drop + CLI add/push + plugin hooks. If you were spun up in this repo without a more specific task, that plan is your task: read it fully, ingest its §1 context list, and execute phase by phase. Check off acceptance boxes and append to its §9 execution log as you go.
House rules
- pnpm only. Node ≥20.
- Tests: vitest —
pnpm --dir cli test. Every new CLI command gets tests incli/test/mirroring the existing style (fixtures undercli/test/fixtures/). - Lint/format: biome —
pnpm --dir cli lint/format. No eslint/prettier here. - Commits: conventional commits (
feat:,fix:,docs:,chore:…). release-please buildsCHANGELOG.mdfrom them — never hand-edit the changelog. - The CLI is published as
@zakelfassi/skdd(npm,cli/package). Don't break existing command flags; additive changes only unless a major is planned. - Skills are spec-bound: every SKILL.md must pass
skdd validate --strict(agentskills.io spec + SkDD lifecycle metadata). Author skills perskillforge/SKILL.md.
Non-goals (binding, from ROADMAP.md)
No hosted registry or server-side skill index (git is the registry). No skill-executing runtime. No review gate on forging (reviewing community imports is different and fine). No semantic search.
Operational guardrails
- Harness mirror dirs (
~/.claude/skills,~/.codex/skills, …) are often populated regular directories holding skills that live in no colony. Neverskdd link --forceover them — it replaces the directory with a symlink and effectively deletes those skills. Mirror logic must stay non-destructive by default. ~/.skdd/on this machine is the maintainer's live global colony, not a test fixture. Use scratch dirs for tests.
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 · 24 lines · 500 tokens per session scan A 48f9214cee9b
skills-driven-development CLAUDE.md is an instructions file published in the GitHub repository zakelfassi/skills-driven-development (18 stars, last pushed 1mo ago), licensed MIT. It adds 500 tokens to every session, about $0.0025 per session on Opus 5. 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 instructions, from other repositories
cortex-mem AGENTS.md
Instructions for sopaco/cortex-mem, covering cortex memory - ai agent context guide, project overview, core concepts, memory dimensions and three-tier layers.
ai-toolkit AGENTS.md
Instructions for pipefy/ai-toolkit, covering repository guidelines, documentation map, project structure, import namespace migration: pipefysdk → pipefy and src/pipefysdk/init.py (transitional shim).
superpowers-reasonix AGENTS.md
Instructions for christopherarter/superpowers-reasonix, covering project guidance, skills — stop. load a skill before you act, red flags — these thoughts mean stop. you are rationalizing and priority.
ai-mind AGENTS.md
Instructions for HWYD/ai-mind, covering agents, version spec workspace continuity (mandatory), 项目定位, 事实来源优先级 and 开始大改前先读什么.
agent-skills AGENTS.md
Instructions for sayeed1999/agent-skills, covering agents.md, output style, output style, 1. think before code and 2. simplicity.
webflow-skills AGENTS.md
Instructions for 224-Industries/webflow-skills, covering 224 industries - webflow agent skills repository, agents.md (symlink to claude.md), repo structure, reference file conventions and content style.