Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
# Project Name
One-sentence description of the project.
## Quick Reference-**Package Manager:** pnpm
-**Build:**`pnpm build`-**Test:**`pnpm test`-**Typecheck:**`pnpm typecheck`## Detailed Instructions
For specific guidelines, see:
- [TypeScript Conventions](.claude/typescript.md)
- [Testing Guidelines](.claude/testing.md)
- [Code Style](.claude/code-style.md)
- [Git Workflow](.claude/git-workflow.md)
- [Architecture Patterns](.claude/architecture.md)
Each linked file template:
# {Topic} Guidelines## Overview
Brief context for when these guidelines apply.
## Rules### Rule Category 1- Specific, actionable instruction
- Another specific instruction
### Rule Category 2- Specific, actionable instruction
## Examples### Good
\`\`\`typescript
// Example of correct pattern
\`\`\`
### Avoid
\`\`\`typescript
// Example of what not to do
\`\`\`
Phase 5: Flag for Deletion
Identify instructions that should be removed entirely.
Delete if:
Criterion
Example
Why Delete
Redundant
"Use TypeScript" (in a .ts project)
Agent already knows
Too vague
"Write clean code"
Not actionable
Overly obvious
"Don't introduce bugs"
Wastes context
Default behavior
"Use descriptive variable names"
Standard practice
Outdated
References deprecated APIs
No longer applies
Output format:
## Flagged for Deletion
| Instruction | Reason |
|-------------|--------|
| "Write clean, maintainable code" | Too vague to be actionable |
| "Use TypeScript" | Redundant - project is already TS |
| "Don't commit secrets" | Agent already knows this |
| "Follow best practices" | Meaningless without specifics |
Execution Checklist
[ ] Phase 1: All contradictions identified and resolved
[ ] Phase 2: Root file contains ONLY essentials
[ ] Phase 3: All remaining instructions categorized
[ ] Phase 4: File structure created with proper links
[ ] Phase 5: Redundant/vague instructions removed
[ ] Verify: Each linked file is self-contained
[ ] Verify: Root file is under 50 lines
[ ] Verify: All links work correctly
Anti-Patterns
Avoid
Why
Instead
Keeping everything in root
Bloated, hard to maintain
Split into linked files
Too many categories
Fragmentation
Consolidate related topics
Vague instructions
Wastes tokens, no value
Be specific or delete
Duplicating defaults
Agent already knows
Only override when needed
Deep nesting
Hard to navigate
Flat structure with links
Examples
Before (Bloated Root)
# CLAUDE.md
This is a React project.
## Code Style- Use 2 spaces
- Use semicolons
- Prefer const over let
- Use arrow functions
... (200 more lines)
## Testing- Use Jest
- Coverage > 80%
... (100 more lines)
## TypeScript- Enable strict mode
... (150 more lines)
After (Progressive Disclosure)
# CLAUDE.md
React dashboard for real-time analytics visualization.
## Commands-`pnpm dev` - Start development server
-`pnpm test` - Run tests with coverage
-`pnpm build` - Production build
## Guidelines- [Code Style](.claude/code-style.md)
- [Testing](.claude/testing.md)
- [TypeScript](.claude/typescript.md)
Verification
After refactoring, verify:
Root file is minimal - Under 50 lines, only universal info
Links work - All referenced files exist
No contradictions - Instructions are consistent
Actionable content - Every instruction is specific
Complete coverage - No instructions were lost (unless flagged for deletion)
Self-contained files - Each linked file stands alone
Credits & Attribution
This skill is based on the excellent work by
Softaworks.
Special thanks to Softaworks for their generous open-source contributions, which helped shape this skill collection.
Adapted by webconsulting.at for this skill collection
