Agent skill
local-issues
Reviews a codebase for bugs, design issues, and code cleanliness problems with specific file paths and line numbers. Use when auditing code quality, finding bugs, doing a code review, finding problems, or reviewing a project for issues. Creates issue files in `.issues/` directory.
Install this agent skill to your Project
npx add-skill https://github.com/philoserf/claude-code-setup/tree/main/skills/local-issues
SKILL.md
Review this codebase for bugs, design issues, and code cleanliness problems. Be specific and cite file paths and line numbers.
Scope the review to $ARGUMENTS if provided, otherwise review the entire project. Examples: src/auth/, lib/api.ts, security, tests/.
What to look for
Prioritize by severity:
| Severity | Category |
|---|---|
| Critical | Security vulnerabilities, data loss, crashes |
| High | Correctness bugs, missing error handling, race conditions |
| Medium | Design issues, code smells, missing validation |
| Low | Style inconsistencies, naming, minor cleanup |
Process
For each issue found:
- Check for duplicates in both GitHub issues (
gh issue list) and the local.issues/directory - Skip if a matching issue already exists
- Otherwise, create a markdown file in
.issues/with a descriptive kebab-case filename
Each issue file should follow this format:
# Title
**Severity:** critical | high | medium | low
**Location:** `file:line`
## Description
What's wrong and why it matters.
## Suggested fix
Concrete recommendation.
Summary
After creating all issue files, output a summary:
| # | Severity | File:Line | Issue |
|---|----------|-----------|-------|
| 1 | high | src/a.ts:42 | Missing null check |
| 2 | medium | lib/b.py:17 | Bare except clause |
Total: {N} issues ({critical} critical, {high} high, {medium} medium, {low} low)
Files created in .issues/
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
pre-release
Validates a project is ready to tag and ship. Use when tagging a release, cutting a version, shipping a package, or asking "are we ready to release?" Checks repo hygiene, CI status, docs, version sync, and build verification. Optimized for Obsidian plugins with fallback detection for other project types.
skill-improve
Generates prioritized improvement recommendations for Claude Code skills. Use when improving skills, enhancing customizations, or wanting actionable feedback on how to make a skill better. Provides impact/effort prioritization with specific fix suggestions.
release
Executes the final release workflow for Obsidian plugins after pre-release checks pass. Use when tagging a release, publishing a version, or shipping an Obsidian plugin. Bumps version via bun run script, creates git tag, pushes to trigger GitHub Actions, and updates GitHub release notes from CHANGELOG.md.
skill-quality
Scores Claude Code skills (1-5) across 6 weighted quality dimensions aligned with official Anthropic docs. Use when evaluating skill quality, rating skills, scoring customizations, comparing skill effectiveness, or checking if a skill follows best practices. Produces per-dimension scores with evidence, weighted totals, quality tier classification, and actionable improvement recommendations.
obsidian-cli
Interacts with Obsidian vaults using the Obsidian CLI to read, create, and manage notes, tasks, properties, tags, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their Obsidian vault, manage notes, add to daily note, find notes about a topic, check tasks, append to a note, query the vault, list tags, list files, manage bookmarks, check sync status, view file history, use templates, query bases, run QuickAdd, perform vault operations from the command line, or develop and debug Obsidian plugins and themes.
cc-check
Runs systematic tests on Claude Code customizations. Use when testing whether a customization works correctly, running functional and regression tests, smoke testing a skill, or validating that a skill or hook behaves as expected. Executes sample queries and validates responses against expected behavior.
Didn't find tool you were looking for?