[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CDR8MB1Q12PHBSN985TSVZ":3,"skill-same:01M6CDR8MB1Q12PHBSN985TSVZ":66},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":26,"publishedAt":31,"linkOnly":32,"markdownContent":33,"markdownBody":34,"frontMatter":35,"refName":36,"commitSha":37,"skillDirectory":38,"forksCount":14,"repositoryHtmlUrl":39,"repositoryHomepageUrl":6,"ownerHtmlUrl":40,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":41,"install":42,"resources":55},"01M6CDR8MB1Q12PHBSN985TSVZ","agent-md-refactor",null,"Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.","illogical\u002FInstructionLibrary","illogical","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1373409?v=4","01M6CDQWC6F1FC0R6ZNCJ56MTR","Matt Moore","01M6CDQWGCHYR449B8K0XEE236",0,"MIT","https:\u002F\u002Fgithub.com\u002Fillogical\u002FInstructionLibrary\u002Fblob\u002Fmain\u002Fskills\u002Fagent-md-refactor\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000007","代码审查","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[27,28,29,30],"refactor","agent md refactor","documentation","files","2026-11-10 10:12:30",false,"---\nname: agent-md-refactor\ndescription: Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.\nlicense: MIT\n---\n\n# Agent MD Refactor\n\nRefactor bloated agent instruction files (AGENTS.md, CLAUDE.md, COPILOT.md, etc.) to follow **progressive disclosure principles** - keeping essentials at root and organizing the rest into linked, categorized files.\n\n---\n\n## Triggers\n\nUse this skill when:\n- \"refactor my AGENTS.md\" \u002F \"refactor my CLAUDE.md\"\n- \"split my agent instructions\"\n- \"organize my CLAUDE.md file\"\n- \"my AGENTS.md is too long\"\n- \"progressive disclosure for my instructions\"\n- \"clean up my agent config\"\n\n---\n\n## Quick Reference\n\n| Phase | Action | Output |\n|-------|--------|--------|\n| 1. Analyze | Find contradictions | List of conflicts to resolve |\n| 2. Extract | Identify essentials | Core instructions for root file |\n| 3. Categorize | Group remaining instructions | Logical categories |\n| 4. Structure | Create file hierarchy | Root + linked files |\n| 5. Prune | Flag for deletion | Redundant\u002Fvague instructions |\n\n---\n\n## Process\n\n### Phase 1: Find Contradictions\n\nIdentify any instructions that conflict with each other.\n\n**Look for:**\n- Contradictory style guidelines (e.g., \"use semicolons\" vs \"no semicolons\")\n- Conflicting workflow instructions\n- Incompatible tool preferences\n- Mutually exclusive patterns\n\n**For each contradiction found:**\n```markdown\n## Contradiction Found\n\n**Instruction A:** [quote]\n**Instruction B:** [quote]\n\n**Question:** Which should take precedence, or should both be conditional?\n```\n\nAsk the user to resolve before proceeding.\n\n---\n\n### Phase 2: Identify the Essentials\n\nExtract ONLY what belongs in the root agent file. The root should be minimal - information that applies to **every single task**.\n\n**Essential content (keep in root):**\n| Category | Example |\n|----------|---------|\n| Project description | One sentence: \"A React dashboard for analytics\" |\n| Package manager | Only if not npm (e.g., \"Uses pnpm\") |\n| Non-standard commands | Custom build\u002Ftest\u002Ftypecheck commands |\n| Critical overrides | Things that MUST override defaults |\n| Universal rules | Applies to 100% of tasks |\n\n**NOT essential (move to linked files):**\n- Language-specific conventions\n- Testing guidelines\n- Code style details\n- Framework patterns\n- Documentation standards\n- Git workflow details\n\n---\n\n### Phase 3: Group the Rest\n\nOrganize remaining instructions into logical categories.\n\n**Common categories:**\n| Category | Contents |\n|----------|----------|\n| `typescript.md` | TS conventions, type patterns, strict mode rules |\n| `testing.md` | Test frameworks, coverage, mocking patterns |\n| `code-style.md` | Formatting, naming, comments, structure |\n| `git-workflow.md` | Commits, branches, PRs, reviews |\n| `architecture.md` | Patterns, folder structure, dependencies |\n| `api-design.md` | REST\u002FGraphQL conventions, error handling |\n| `security.md` | Auth patterns, input validation, secrets |\n| `performance.md` | Optimization rules, caching, lazy loading |\n\n**Grouping rules:**\n1. Each file should be self-contained for its topic\n2. Aim for 3-8 files (not too granular, not too broad)\n3. Name files clearly: `{topic}.md`\n4. Include only actionable instructions\n\n---\n\n### Phase 4: Create the File Structure\n\n**Output structure:**\n```\nproject-root\u002F\n├── CLAUDE.md (or AGENTS.md)     # Minimal root with links\n└── .claude\u002F                      # Or docs\u002Fagent-instructions\u002F\n    ├── typescript.md\n    ├── testing.md\n    ├── code-style.md\n    ├── git-workflow.md\n    └── architecture.md\n```\n\n**Root file template:**\n```markdown\n# Project Name\n\nOne-sentence description of the project.\n\n## Quick Reference\n\n- **Package Manager:** pnpm\n- **Build:** `pnpm build`\n- **Test:** `pnpm test`\n- **Typecheck:** `pnpm typecheck`\n\n## Detailed Instructions\n\nFor specific guidelines, see:\n- [TypeScript Conventions](.claude\u002Ftypescript.md)\n- [Testing Guidelines](.claude\u002Ftesting.md)\n- [Code Style](.claude\u002Fcode-style.md)\n- [Git Workflow](.claude\u002Fgit-workflow.md)\n- [Architecture Patterns](.claude\u002Farchitecture.md)\n```\n\n**Each linked file template:**\n```markdown\n# {Topic} Guidelines\n\n## Overview\nBrief context for when these guidelines apply.\n\n## Rules\n\n### Rule Category 1\n- Specific, actionable instruction\n- Another specific instruction\n\n### Rule Category 2\n- Specific, actionable instruction\n\n## Examples\n\n### Good\n\\`\\`\\`typescript\n\u002F\u002F Example of correct pattern\n\\`\\`\\`\n\n### Avoid\n\\`\\`\\`typescript\n\u002F\u002F Example of what not to do\n\\`\\`\\`\n```\n\n---\n\n### Phase 5: Flag for Deletion\n\nIdentify instructions that should be removed entirely.\n\n**Delete if:**\n| Criterion | Example | Why Delete |\n|-----------|---------|------------|\n| Redundant | \"Use TypeScript\" (in a .ts project) | Agent already knows |\n| Too vague | \"Write clean code\" | Not actionable |\n| Overly obvious | \"Don't introduce bugs\" | Wastes context |\n| Default behavior | \"Use descriptive variable names\" | Standard practice |\n| Outdated | References deprecated APIs | No longer applies |\n\n**Output format:**\n```markdown\n## Flagged for Deletion\n\n| Instruction | Reason |\n|-------------|--------|\n| \"Write clean, maintainable code\" | Too vague to be actionable |\n| \"Use TypeScript\" | Redundant - project is already TS |\n| \"Don't commit secrets\" | Agent already knows this |\n| \"Follow best practices\" | Meaningless without specifics |\n```\n\n---\n\n## Execution Checklist\n\n```\n[ ] Phase 1: All contradictions identified and resolved\n[ ] Phase 2: Root file contains ONLY essentials\n[ ] Phase 3: All remaining instructions categorized\n[ ] Phase 4: File structure created with proper links\n[ ] Phase 5: Redundant\u002Fvague instructions removed\n[ ] Verify: Each linked file is self-contained\n[ ] Verify: Root file is under 50 lines\n[ ] Verify: All links work correctly\n```\n\n---\n\n## Anti-Patterns\n\n| Avoid | Why | Instead |\n|-------|-----|---------|\n| Keeping everything in root | Bloated, hard to maintain | Split into linked files |\n| Too many categories | Fragmentation | Consolidate related topics |\n| Vague instructions | Wastes tokens, no value | Be specific or delete |\n| Duplicating defaults | Agent already knows | Only override when needed |\n| Deep nesting | Hard to navigate | Flat structure with links |\n\n---\n\n## Examples\n\n### Before (Bloated Root)\n```markdown\n# CLAUDE.md\n\nThis is a React project.\n\n## Code Style\n- Use 2 spaces\n- Use semicolons\n- Prefer const over let\n- Use arrow functions\n... (200 more lines)\n\n## Testing\n- Use Jest\n- Coverage > 80%\n... (100 more lines)\n\n## TypeScript\n- Enable strict mode\n... (150 more lines)\n```\n\n### After (Progressive Disclosure)\n```markdown\n# CLAUDE.md\n\nReact dashboard for real-time analytics visualization.\n\n## Commands\n- `pnpm dev` - Start development server\n- `pnpm test` - Run tests with coverage\n- `pnpm build` - Production build\n\n## Guidelines\n- [Code Style](.claude\u002Fcode-style.md)\n- [Testing](.claude\u002Ftesting.md)\n- [TypeScript](.claude\u002Ftypescript.md)\n```\n\n---\n\n## Verification\n\nAfter refactoring, verify:\n\n1. **Root file is minimal** - Under 50 lines, only universal info\n2. **Links work** - All referenced files exist\n3. **No contradictions** - Instructions are consistent\n4. **Actionable content** - Every instruction is specific\n5. **Complete coverage** - No instructions were lost (unless flagged for deletion)\n6. **Self-contained files** - Each linked file stands alone\n\n---\n","# Agent MD Refactor\n\nRefactor bloated agent instruction files (AGENTS.md, CLAUDE.md, COPILOT.md, etc.) to follow **progressive disclosure principles** - keeping essentials at root and organizing the rest into linked, categorized files.\n\n---\n\n## Triggers\n\nUse this skill when:\n- \"refactor my AGENTS.md\" \u002F \"refactor my CLAUDE.md\"\n- \"split my agent instructions\"\n- \"organize my CLAUDE.md file\"\n- \"my AGENTS.md is too long\"\n- \"progressive disclosure for my instructions\"\n- \"clean up my agent config\"\n\n---\n\n## Quick Reference\n\n| Phase | Action | Output |\n|-------|--------|--------|\n| 1. Analyze | Find contradictions | List of conflicts to resolve |\n| 2. Extract | Identify essentials | Core instructions for root file |\n| 3. Categorize | Group remaining instructions | Logical categories |\n| 4. Structure | Create file hierarchy | Root + linked files |\n| 5. Prune | Flag for deletion | Redundant\u002Fvague instructions |\n\n---\n\n## Process\n\n### Phase 1: Find Contradictions\n\nIdentify any instructions that conflict with each other.\n\n**Look for:**\n- Contradictory style guidelines (e.g., \"use semicolons\" vs \"no semicolons\")\n- Conflicting workflow instructions\n- Incompatible tool preferences\n- Mutually exclusive patterns\n\n**For each contradiction found:**\n```markdown\n## Contradiction Found\n\n**Instruction A:** [quote]\n**Instruction B:** [quote]\n\n**Question:** Which should take precedence, or should both be conditional?\n```\n\nAsk the user to resolve before proceeding.\n\n---\n\n### Phase 2: Identify the Essentials\n\nExtract ONLY what belongs in the root agent file. The root should be minimal - information that applies to **every single task**.\n\n**Essential content (keep in root):**\n| Category | Example |\n|----------|---------|\n| Project description | One sentence: \"A React dashboard for analytics\" |\n| Package manager | Only if not npm (e.g., \"Uses pnpm\") |\n| Non-standard commands | Custom build\u002Ftest\u002Ftypecheck commands |\n| Critical overrides | Things that MUST override defaults |\n| Universal rules | Applies to 100% of tasks |\n\n**NOT essential (move to linked files):**\n- Language-specific conventions\n- Testing guidelines\n- Code style details\n- Framework patterns\n- Documentation standards\n- Git workflow details\n\n---\n\n### Phase 3: Group the Rest\n\nOrganize remaining instructions into logical categories.\n\n**Common categories:**\n| Category | Contents |\n|----------|----------|\n| `typescript.md` | TS conventions, type patterns, strict mode rules |\n| `testing.md` | Test frameworks, coverage, mocking patterns |\n| `code-style.md` | Formatting, naming, comments, structure |\n| `git-workflow.md` | Commits, branches, PRs, reviews |\n| `architecture.md` | Patterns, folder structure, dependencies |\n| `api-design.md` | REST\u002FGraphQL conventions, error handling |\n| `security.md` | Auth patterns, input validation, secrets |\n| `performance.md` | Optimization rules, caching, lazy loading |\n\n**Grouping rules:**\n1. Each file should be self-contained for its topic\n2. Aim for 3-8 files (not too granular, not too broad)\n3. Name files clearly: `{topic}.md`\n4. Include only actionable instructions\n\n---\n\n### Phase 4: Create the File Structure\n\n**Output structure:**\n```\nproject-root\u002F\n├── CLAUDE.md (or AGENTS.md)     # Minimal root with links\n└── .claude\u002F                      # Or docs\u002Fagent-instructions\u002F\n    ├── typescript.md\n    ├── testing.md\n    ├── code-style.md\n    ├── git-workflow.md\n    └── architecture.md\n```\n\n**Root file template:**\n```markdown\n# Project Name\n\nOne-sentence description of the project.\n\n## Quick Reference\n\n- **Package Manager:** pnpm\n- **Build:** `pnpm build`\n- **Test:** `pnpm test`\n- **Typecheck:** `pnpm typecheck`\n\n## Detailed Instructions\n\nFor specific guidelines, see:\n- [TypeScript Conventions](.claude\u002Ftypescript.md)\n- [Testing Guidelines](.claude\u002Ftesting.md)\n- [Code Style](.claude\u002Fcode-style.md)\n- [Git Workflow](.claude\u002Fgit-workflow.md)\n- [Architecture Patterns](.claude\u002Farchitecture.md)\n```\n\n**Each linked file template:**\n```markdown\n# {Topic} Guidelines\n\n## Overview\nBrief context for when these guidelines apply.\n\n## Rules\n\n### Rule Category 1\n- Specific, actionable instruction\n- Another specific instruction\n\n### Rule Category 2\n- Specific, actionable instruction\n\n## Examples\n\n### Good\n\\`\\`\\`typescript\n\u002F\u002F Example of correct pattern\n\\`\\`\\`\n\n### Avoid\n\\`\\`\\`typescript\n\u002F\u002F Example of what not to do\n\\`\\`\\`\n```\n\n---\n\n### Phase 5: Flag for Deletion\n\nIdentify instructions that should be removed entirely.\n\n**Delete if:**\n| Criterion | Example | Why Delete |\n|-----------|---------|------------|\n| Redundant | \"Use TypeScript\" (in a .ts project) | Agent already knows |\n| Too vague | \"Write clean code\" | Not actionable |\n| Overly obvious | \"Don't introduce bugs\" | Wastes context |\n| Default behavior | \"Use descriptive variable names\" | Standard practice |\n| Outdated | References deprecated APIs | No longer applies |\n\n**Output format:**\n```markdown\n## Flagged for Deletion\n\n| Instruction | Reason |\n|-------------|--------|\n| \"Write clean, maintainable code\" | Too vague to be actionable |\n| \"Use TypeScript\" | Redundant - project is already TS |\n| \"Don't commit secrets\" | Agent already knows this |\n| \"Follow best practices\" | Meaningless without specifics |\n```\n\n---\n\n## Execution Checklist\n\n```\n[ ] Phase 1: All contradictions identified and resolved\n[ ] Phase 2: Root file contains ONLY essentials\n[ ] Phase 3: All remaining instructions categorized\n[ ] Phase 4: File structure created with proper links\n[ ] Phase 5: Redundant\u002Fvague instructions removed\n[ ] Verify: Each linked file is self-contained\n[ ] Verify: Root file is under 50 lines\n[ ] Verify: All links work correctly\n```\n\n---\n\n## Anti-Patterns\n\n| Avoid | Why | Instead |\n|-------|-----|---------|\n| Keeping everything in root | Bloated, hard to maintain | Split into linked files |\n| Too many categories | Fragmentation | Consolidate related topics |\n| Vague instructions | Wastes tokens, no value | Be specific or delete |\n| Duplicating defaults | Agent already knows | Only override when needed |\n| Deep nesting | Hard to navigate | Flat structure with links |\n\n---\n\n## Examples\n\n### Before (Bloated Root)\n```markdown\n# CLAUDE.md\n\nThis is a React project.\n\n## Code Style\n- Use 2 spaces\n- Use semicolons\n- Prefer const over let\n- Use arrow functions\n... (200 more lines)\n\n## Testing\n- Use Jest\n- Coverage > 80%\n... (100 more lines)\n\n## TypeScript\n- Enable strict mode\n... (150 more lines)\n```\n\n### After (Progressive Disclosure)\n```markdown\n# CLAUDE.md\n\nReact dashboard for real-time analytics visualization.\n\n## Commands\n- `pnpm dev` - Start development server\n- `pnpm test` - Run tests with coverage\n- `pnpm build` - Production build\n\n## Guidelines\n- [Code Style](.claude\u002Fcode-style.md)\n- [Testing](.claude\u002Ftesting.md)\n- [TypeScript](.claude\u002Ftypescript.md)\n```\n\n---\n\n## Verification\n\nAfter refactoring, verify:\n\n1. **Root file is minimal** - Under 50 lines, only universal info\n2. **Links work** - All referenced files exist\n3. **No contradictions** - Instructions are consistent\n4. **Actionable content** - Every instruction is specific\n5. **Complete coverage** - No instructions were lost (unless flagged for deletion)\n6. **Self-contained files** - Each linked file stands alone\n\n---\n",{"name":5,"license":15,"description":7},"main","2637920fd5def1193266b1f848a566e4758bb7d0","skills\u002Fagent-md-refactor","https:\u002F\u002Fgithub.com\u002Fillogical\u002FInstructionLibrary","https:\u002F\u002Fgithub.com\u002Fillogical","2026-04-05 03:21:45",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add illogical\u002FInstructionLibrary --skill agent-md-refactor",{"tool":48,"command":49},"bunx","bunx skills add illogical\u002FInstructionLibrary --skill agent-md-refactor",{"tool":51,"command":52},"pnpm","pnpm dlx skills add illogical\u002FInstructionLibrary --skill agent-md-refactor","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fillogical\u002FInstructionLibrary\u002Fblob\u002Fmain\u002Fskills\u002Fagent-md-refactor\u002FSKILL.md",true,[56,62],{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"README.md","REFERENCE","参考文档",7326,"https:\u002F\u002Fgithub.com\u002Fillogical\u002FInstructionLibrary\u002Fblob\u002Fmain\u002Fskills\u002Fagent-md-refactor\u002FREADME.md",{"path":63,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":64,"sourceHtmlUrl":65},"references\u002Fapi_reference.md",16384,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fscientific-skills\u002Fmetabolomics-workbench-database\u002Freferences\u002Fapi_reference.md",[]]