Create Spec
This generates a specification document for features or refactors by mining existing research in your codebase and organizing it around a philosophy: a system's entrypoints are its theory of purpose. It pushes you to design APIs, routes, and handlers that reveal domain intent rather than implementation detail, then runs each through a ten-point rubric asking whether the door is honestly named, whether it makes illegal states unrepresentable, and whether a stranger could reconstruct the system's purpose from the signatures alone. The output lands in specs/ as a dated markdown file. Use it when you're about to build something non-trivial and want the design work documented before the first commit, especially if you've already done research passes and need to turn findings into a coherent plan.
- skills.sh installs
- 168
- GitHub stars
- 234
- last updated
- Jun 3, 2026
Install
$ npx -y skills add flora131/atomic --skill create-spec --agent claude-codeInstalls into .claude/skills of the current project.
Files
You are tasked with creating a spec for implementing a new feature or system change in the codebase by leveraging existing research in the $ARGUMENTS path. If no research path is specified, use the entire research/ directory. IMPORTANT: Research documents are located in the research/ directory — do NOT look in the specs/ directory for research. Follow the template below to produce a comprehensive specification as output in the specs/ folder using the findings from RELEVANT research documents found in research/. The spec file MUST be named using the format YYYY-MM-DD-topic.md (e.g., specs/2026-03-26-my-feature.md), where the date is the current date and the topic is a kebab-case summary. Tip: It's good practice to use the codebase-research-locator and codebase-research-analyzer agents to help you find and analyze the research documents in the research/ directory. It is also HIGHLY recommended to cite relevant research throughout the spec for additional context.
Ask Clarifying Questions Before You Start
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/flora131/atomic
- First seen
- Jun 3, 2026
More from flora131/atomic
All 39- Sl Commit168
- Sl Submit Diff168
- Bun166
- Context Optimization166
- Docx166
- Impeccable166
- Init166
- Playwright Cli166
- Skill Creator166
- Find Skills165
- Liteparse165
- Pdf165
- Pptx165
- Xlsx165
- Bdi Mental States164
- Context Degradation164
- Context Fundamentals164
- Filesystem Context164
- Memory Systems164
- Project Development164
- Tool Design164
- Typescript Advanced Types164
- Advanced Evaluation163
- Opentui163
Recommended
cavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
improveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
karpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
find-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs