Feedback on your every-style-editor skill #66
Description
I took a look at your every-style-editor skill and wanted to share some thoughts.
Links:
The TL;DR
You're at 83/100, which puts you solidly in B territory - good fundamentals with some polish work to do. Your Progressive Disclosure Architecture is your strongest area (26/30), meaning you've nailed the token-efficient layering between your main SKILL.md and the comprehensive EVERY_WRITE_STYLE.md reference. The gaps are mostly around metadata and consistency rather than core design.
What's Working Well
- Excellent layering strategy - Your 135-line SKILL.md efficiently summarizes workflow while delegating the full 530-line style guide to a reference file. That's exactly how PDA should work.
- Solid structured output - The template with line-by-line checklist gives users clear direction on what to deliver. The examples in your reference file make it actionable.
- Practical problem-solving - You're addressing a real need (consistent editorial review), and your style guide rules are thorough enough to actually guide someone through edits.
The Big One: Description Needs Trigger Phrases
This is the main opportunity holding you back. Your frontmatter description says "This skill should be used when reviewing or editing copy..." but it's missing the explicit trigger phrases that help discoverability.
Why it matters: When someone asks Claude "review this for style", the system needs to know this skill exists. Right now, it's relying on fuzzy matching instead of direct keywords.
The fix: Update your SKILL.md frontmatter description to include triggers like:
"Use when asked to review style, perform line editing, check grammar compliance, proofread for tone, or ensure adherence to Every's style guide."
This bump alone gets you +2 points (83→85).
Other Things Worth Fixing
-
Mixed voice throughout SKILL.md - You jump between "This skill enables performing..." (third person) and "Begin by reading..." (imperative). Pick one and be consistent. Lean imperative since that's more scannable.
-
The 530-line reference needs a TOC - Without a table of contents, someone looking for "Capitalization rules" has to scroll forever. Add links to major sections (Abbreviations, Capitalization, Commas, etc.) at the top. That's +1 point of easy wins.
-
Key Principles section duplicates Step 2 - Both cover punctuation, capitalization, passive voice. Merge or cut one to tighten the overall flow. Redundancy eats token budget.
Quick Wins
Most impactful first:
- Add trigger phrases to description → +2 points
- Add TOC to EVERY_WRITE_STYLE.md → +1 point
- Standardize voice (imperative throughout) → +2 points
- Remove redundancy between Key Principles and Step 2 → +1 point
That's 6 points of relatively quick improvements getting you to 89/100 (solid A territory).
Checkout your skill here: [SkillzWave.ai](https://skillzwave.ai) | [SpillWave](https://spillwave.com) We have an agentic skill installer that install skills in 14+ coding agent platforms. Check out this guide on how to improve your agentic skills.