Refactor Skill Structure
Skill Verifiziert AktivRefactor 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.
Funktionen
- 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
Anwendungsfälle
- 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.
Nicht-Ziele
- 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.
Installation
/plugin install agent-almanac@pjt222-agent-almanacQualitätspunktzahl
VerifiziertVertrauenssignale
Ähnliche Erweiterungen
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
100Nutzen Sie dies, wenn der Benutzer eine Repository-README übersetzen, ein Repository mehrsprachig machen, Dokumentationen lokalisieren, einen Sprachumschalter hinzufügen, die README internationalisieren oder lokalisierte README-Varianten in einem GitHub-ähnlichen Repository aktualisieren möchte.
Pathfinder
100Ordnet eine Codebasis in Feature-gruppierte Flussdiagramme ein, identifiziert doppelte Belange über Features hinweg und schlägt eine einheitliche Architektur vor. Wird verwendet, wenn nach "dem idealen Pfad" gefragt wird, duplizierte Systeme vereinheitlicht oder die Architektur vor einem Refactoring auditiert werden soll. Gibt ein vorgeschlagenes einheitliches Flussdiagramm sowie Prompts zum Erstellen eines Plans pro System aus.
Migrate Validate
100Validate pending migrations for foreign key consistency, rollback safety, and best practices