Refactor Skill Structure
技能 已验证 活跃Refactor an over-long or poorly structured SKILL.md by extracting examples to references/EXAMPLES.md, splitting compound procedures, and reorganizing sections for progressive disclosure. Use when a skill exceeds the 500-line CI limit, when code blocks dominate the skill body, when a procedure step contains multiple unrelated operations, or after a content update pushed the skill over the line limit.
To maintain and improve the quality and readability of SKILL.md documentation by automating the process of restructuring and reducing line counts.
功能
- Extracts code blocks >15 lines to references/EXAMPLES.md
- Splits compound procedure steps into focused operations
- Adds cross-references for progressive disclosure
- Validates skill structure and frontmatter integrity
- Provides guidance on managing line counts and content organization
使用场景
- When a skill exceeds the 500-line CI limit.
- When a single procedure step contains multiple unrelated operations.
- When code blocks dominate the skill body and could be extracted.
- After content updates push the skill over the line limit.
非目标
- Performing content quality edits unrelated to structure or line count.
- Splitting a skill into multiple independent skills (prefer extraction first).
- Handling the creation of new skills, only restructuring existing ones.
安装
/plugin install agent-almanac@pjt222-agent-almanac质量评分
已验证类似扩展
Moyu (摸鱼)
100감지된 과잉 엔지니어링 패턴: (1) 사용자가 명시적으로 요청하지 않은 코드나 파일을 수정할 때 (2) 요청되지 않은 새로운 추상화 계층(클래스, 인터페이스, 팩토리, 래퍼)을 생성할 때 (3) 요청되지 않은 주석, 문서, JSDoc, 타입 주석을 추가할 때 (4) 요청되지 않은 새로운 종속성을 도입할 때 (5) 최소 편집 대신 파일 전체를 다시 작성할 때 (6) diff 범위가 사용자의 요청을 명백히 초과할 때 (7) 사용자가 "너무 많아", "거기는 건드리지 마", "X만 변경해", "간단하게", "그만"과 같은 신호를 보낼 때 (8) 발생할 수 없는 시나리오에 대한 오류 처리, 유효성 검사, 방어적 코드를 추가할 때 (9) 요청되지 않은 테스트, 설정 스캐폴딩, 문서를 생성할 때
Cleanup Cycles
100Detect and untangle circular dependencies. Runs madge/skott (TS), pycycle (Py), or compiler-only checks (Go/Rust). Auto-fixes leaf-extractable cycles; reports core cycles for human review. Use when the user asks to find circular imports, fix dependency cycles, or untangle module graph. Example queries — "find circular imports", "fix dependency cycles", "untangle our module graph", "why is madge complaining".
Coding Standards
100Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed frontend or backend skills for framework-specific patterns.
Readme I18n
100当用户想要翻译存储库 README、使存储库支持多语言、本地化文档、添加语言切换器、国际化 README 或更新 GitHub 风格存储库中的本地化 README 变体时使用。
Pathfinder
100将代码库映射为按功能分组的流程图，识别不同功能之间的重复关注点，并提出统一的架构。在被要求“寻找理想路径”、统一重复系统或在重构前审计架构时使用。输出一个建议的统一流程图以及针对每个系统的“制定计划”提示。
Migrate Validate
100Validate pending migrations for foreign key consistency, rollback safety, and best practices