Readability Feedback
JetBrains/youtrackdb/.claude/skills/readability-feedback
ai-mlOfficial
Official Provider SkillView repo
Audit a finished design document for hard-to-read or hard-to-understand paragraphs, then harden the house-style rules so future design docs avoid them. Fans out audit sub-agents, classifies each obscure passage as caught-by-an-existing-rule or a gap, and proposes plus (on approval) applies rule changes across the style docs. Use when the user wants to feed a design doc back into the style guide, find obscure paragraphs and fix the rules, harden the writing rules from a real DD, or close the read
Files1 files
SKILL.md95 lines
Loading editor…
Install
RecommendedOne command — your agent picks it up automatically.
Select an AI agent above to see the install command.
or
Manual Install
More stepsDownload the file and paste it into your agent's system prompt.
Skill details
Versionv1.0.0
AuthorJetBrains
Categoryai-ml
Skill IDJetBrains/youtrackdb/.claude/skills/readability-feedback
Related skills
Ai TellsReviews any draft for AI writing tells and produces a clean rewrite. Catches structural fingerprints (negative parallelism like "It's not X, it's Y", bullet-everything, Title Case headings, adjective triads), analysis fingerprints (superficial -ing clauses, passive voice, vague attribution, hedge stacking), and tone fingerprints (throat-clearing, closing phrases like "In conclusion"). Use this skill whenever the user asks to humanize, de-AI, edit, polish, or sanity-check writing, including phrasAnalyze ChangesAnalyze git changes (branch, commit, or current branch) and produce a design-oriented markup document with Mermaid diagrams, query/usage examples, data walkthroughs, PR context, and impact assessment.Code ReviewReview code, test, and workflow-machinery changes across multiple dimensions using specialized agents with triage-based selection.Create PlanResearch the codebase and create an implementation plan with architecture notes, design document, and track decomposition. Use when starting a new feature or large change.Create PresentationGenerate a PPTX presentation explaining code changes on the current branch, with matplotlib diagrams and dark theme slides.Edit DesignApply an edit to `design.md` or `design-mechanics.md` through the mutation discipline: apply → auto-review → iterate → present. Use this instead of directly Editing those files.