Best use case
identify-style-issues is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Identify divergences from the style guide in the $1 library
Teams using identify-style-issues should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/identify-style-issues/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How identify-style-issues Compares
| Feature / Agent | identify-style-issues | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Identify divergences from the style guide in the $1 library
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
Go gather all the context for the $1 library (per instructions in CLAUDE.md). Be sure to read non_issues.md as well. Once you've gathered that context, please do the below (and commit when you're finished). Your task is to identify any places where the $1 library diverges from the established style guide (style_guide.md). Focus on the higher-level aspects of the style guide, such as code structure, organization, and design patterns (worry less about anything that should be caught by an automated linter or a ratchet). In fact, for this reason it is important to go look at the existing ratchet tests--do NOT mention anything that is already covered by those tests. If there are inconsistencies within the style guide itself (or aspects that it leaves ambiguous), please note those as well. Do NOT report issues that are already covered by an existing FIXME Do NOT report issues that are highlighted as non-issues in non_issues.md After reviewing all the code in the library, think carefully about the most important stylistic inconsistencies and issues. Then put them, in order from most important to least important, into a markdown file in the library's "_tasks/style/" folder (make one if you have to) Name the file "<date>.md` (where you should get "date" by calling this precise command: "date +%Y-%m-%d-%T | tr : -") For the format of the file, use the following: ```markdown # Style issues in the $1 library (identified on <date>) ## 1. <Short description of style issue> Description: <detailed description of the style issue, including file names and line numbers where applicable> Recommendation: <your recommendation for how to fix the style issue> Decision: Accept ## 2. <Short description of style issue> Description: <detailed description of the style issue, including file names and line numbers where applicable> Recommendation: <your recommendation for how to fix the style issue> Decision: Accept ... ``` There's no need to commit when you're done (these files are gitignored). Just be sure to create the file in the right location with the right content.
Related Skills
update-issues-in-repo
Convert a file containing identified issues into a tracked file in current_tasks/. Use after running identify-* commands to create a local record of current issues.
identify-outdated-docstrings
Identify outdated docstrings in the $1 library
identify-inconsistencies
Identify inconsistencies in the $1 library
identify-doc-code-disagreements
Identify places in the $1 library where the docs and code disagree
create-github-issues-from-file
Convert a file containing identified issues into GitHub issues. Use after running identify-* commands to create corresponding GitHub issues.
convert-github-issues-to-fixmes
Convert triaged autoclaude GitHub issues into FIXMEs in the codebase. Use when you want to process issues that have been triaged by authorized users.
writing-specs
Write high quality specifications or design docs for a program. Use any time you are asked to write, improve, or update specs / design docs (e.g., files in a `specs/` folder).
writing-ratchet-tests
Write ratchet tests to prevent accumulation of code anti-patterns. Use when asked to create a "ratchet test" for tracking and preventing specific code patterns (e.g., TODO comments, inline imports, broad exception handling).
writing-docs
Write high quality, user-facing documentation. Use any time you need to write, improve, or update a significant amount of user-facing documentation (e.g., files in a "docs/" folder or README file).
wait-for-agent
Wait for another agent to enter WAITING state, then execute follow-up instructions
triage-backlog
Interactively triage the user's local engineering backlog file into GitHub issues. Use when the user wants to process their raw thought notes / ticket backlog into proper GitHub issues.
think-of-something-to-fix
Come up with good ideas about what to fix. Use when you have to fix something, but you're not sure what.