CommunityWriting & Editinggithub.com

AaronCx/claude-code-practices

Interview the user in depth about a feature, then write a self-contained SPEC.md to implement from in a fresh session. Use before building anything large.

What is claude-code-practices?

claude-code-practices is a Claude Code agent skill that interview the user in depth about a feature, then write a self-contained SPEC.md to implement from in a fresh session. Use before building anything large.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AaronCx/claude-code-practices/tree/HEAD/skills/spec-interview

Installed? Explore more Writing & Editing skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

The user wants to build: $ARGUMENTS

Interview them in detail using the AskUserQuestion tool. Ask about technical implementation, UI/UX, edge cases, concerns, and tradeoffs. Do not ask obvious questions; dig into the hard parts they might not have considered. Keep interviewing until everything is covered.

Then write a complete spec to SPEC.md. The most useful specs are self-contained: name the files and interfaces involved, state what is out of scope, and end with an end-to-end verification step that proves the feature works.

Finish by telling the user to run /clear and implement from SPEC.md in a fresh session, so the implementation context holds only the spec.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Related Skills