Mini Spec
MANDATORY: Invoke BEFORE writing or modifying any code. Without `design/design.md` you lack critical knowledge of component relationships, responsibilities, and code mappings — changes made without this context risk breaking architectural invariants. Do NOT explore code with other tools first. Load this skill before doing anything else.
Install
npx skills add zot/mini-spec --skill mini-specgit clone --depth 1 https://github.com/zot/mini-spec.git /tmp/mini-spec
mkdir -p ~/.claude/skills
cp -r /tmp/mini-spec/.claude/skills/mini-spec ~/.claude/skills/mini-specPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Mini-spec ## Load the model first **IMMEDIATELY invoke `/minimap` using the Skill tool before doing anything else.** It carries the structural *model* this skill builds on: the 3-level spec→design→code layout, what each level is for, where artifacts live, the **root spec index**, what a **summary spec** is, and the **traceability links** (`Rn` → CRC card → code `// CRC:/Seq:` comment) that stitch the levels together. Start at the design docs and the root index, not at code — drop into code-level tools (Serena, Grep, etc.) only after they've oriented you. This skill adds the **process** — phases, traceability *maintenance*, gaps, migrations, trajectory tracking — on top of that model. ## Prerequisite: Version Check and Comment Patterns **First**, run `~/.claude/bin/minispec check-version` to verify the tool is installed and matches this skill's version. If it fails, warn the user: the tool and skill must be the same version or there will be compatibility issues. **Then**, run `~/.claude/bin/minispec query comment-patterns` to learn how to write a traceability comment in each extension, closers included. ## MANDATORY: Create Tasks First **BEFORE reading any files or doing any work**, create tasks for applicable phases:
Details
- Skill name
mini-spec- Repository
- zot/mini-spec
- Path
.claude/skills/mini-spec/SKILL.md- License
- MIT
- Repo updated
- 2 November 2026
FAQ
What does the Mini Spec skill do?
**MANDATORY: Invoke BEFORE writing or modifying any code.** Without `design/design.md` you lack critical knowledge of component relationships, responsibilities, and code mappings — changes made without this context risk breaking architectural invariants. Do NOT explore code with other tools first. Load this skill before doing anything else.
How do I install the Mini Spec skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add zot/mini-spec --skill mini-spec. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Mini Spec popular?
It lives in zot/mini-spec, which has 5 GitHub stars and 1 forks.
Related skills
Minimap
5zot/mini-spec
The mini-spec structural model in miniature — the 3-level spec→design→code layout, where artifacts live, the root spec index, and the traceability links that connect them. Load to navigate or search a mini-spec project across specs, design, and code (the model, not the maintenance process). Foundation for mini-spec.
Ncd
9Vincent-the-gamer/skills
ncd (ncm dumper) is a CLI for batch-converting .ncm files to .mp3. Use when the user says using ncd to convert .ncm files.
Pipeline Expert
10meshmakers/octo-claude-skills
Authoring, reading, editing, debugging, and validating OctoMesh ETL pipeline YAML — the node-by-node config, DataContext/JSONPath data flow, triggers, transformations, entity CRUD via CreateUpdateInfo/ApplyChanges, archive (CrateDB) writes, inter-pipeline chaining within a DataFlow, and deployment/debug troubleshooting. Use whenever someone builds or fixes a pipeline definition or asks what a node does. Trigger on: pipeline YAML, pipeline node, node configuration, DataContext, ForEach, For, DataFlow, PipelineTrigger, cron schedule, ToPipelineDataEvent, FromPipelineDataEvent, FromPipelineTrigge
Node CLI Creator
9Vincent-the-gamer/skills
Build a Node.js CLI in TypeScript — commands parsed with cac, code built with tsdown, deps updated with taze, source run with tsx. Use when the user wants to create, develop, or add features to a Node.js command-line tool or CLI project.
Octo
10meshmakers/octo-claude-skills
Primary entry point and router for ALL OctoMesh tasks. Drives the octo-cli for platform administration (users, roles, groups, tenants, clients, identity providers, blueprints, CK catalog/library management, stream-data archives, communication adapters/pipelines, AI services) and explores the data model and runtime instances via GraphQL. Routes specialized work to sibling skills. When unsure which OctoMesh skill to use, start here. Trigger on: OctoMesh, octo-cli, CLI command, environment switch, auth/login, AuthStatus, tenant, temporary tenant, test tenant, user, role, group, client credentials
Review Change
9jbaruch/agentic-context-registry
Review a Go change when the user asks to inspect a diff for correctness.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.