Skip to content

chore: reduce SKILL.md from 2,850 to ~500 words #9

@CybotTM

Description

@CybotTM

Quality Review Finding

Per marketplace tracking issue, this skill has critical quality issues:

Word count: 2,850 (target: <500)

Issues

  1. 35+ sections — overcomplicated structure. Collapse to 4-5: Overview, When to Use, Quick Workflow, Key Commands, Common Gotchas
  2. Narrative tone — "Agent-Optimized Design" section is essay, not actionable
  3. "CRITICAL: Full Verification Required" — 97 lines that should be references/verification-checklist.md
  4. "Language Choice" section — belongs in references/language-choice.md
  5. macOS troubleshooting — belongs in references/troubleshooting.md

Recommended Actions

  • Move verification checklist (97 lines) to references/verification-checklist.md
  • Move language choice to references/language-choice.md
  • Move macOS section to references
  • Collapse 35+ sections into 4-5 core sections
  • Rewrite frontmatter description to only list trigger conditions
  • Target: ~400-500 words in SKILL.md

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions