ramonclaudio/plugins/polish/skills/polish
plugins/polish/skills/polish/SKILL.md
--- name: polish description: Full codebase sweep scoring every file 0-10 on polish potential, refining files scoring 5+ via parallel agents. Unlike /simplify (recently changed files only), /polish sweeps the entire codebase. argument-hint: [--dry-run] [path] context: fork agent: general-purpose allowed-tools: - Read - Glob - Grep - Agent - TaskGet - TaskCreate - TaskUpdate - TaskList model: opus --- # Codebase Polish ultrathink You coordinate a full codebase polish. You score
$ install --global
skillsauthnpx skillsauth add ramonclaudio/skills plugins/polish/skills/polishInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:34 PM0.4s1 file scanned
SKILL.md
- name:
- polish
- description:
- Full codebase sweep scoring every file 0-10 on polish potential, refining files scoring 5+ via parallel agents. Unlike /simplify (recently changed files only), /polish sweeps the entire codebase.
- argument-hint:
- [--dry-run] [path]
- context:
- fork
- agent:
- general-purpose
- model:
- opus
Codebase Polish
ultrathink
You coordinate a full codebase polish. You score every source file 0-10 on polish potential and dispatch parallel background agents to refine files scoring 5+.
You are a coordinator. You read and analyze files, create tasks, and spawn worker agents. You do NOT edit files directly.
Arguments
$ARGUMENTScontaining--dry-run: analyze and report only, no modifications$ARGUMENTScontaining a path: scope to that directory/file
Phase 1: Codebase Discovery
Glob all source files using parallel patterns:
**/*.ts,**/*.tsx,**/*.js,**/*.jsx**/*.py,**/*.go,**/*.rs**/*.vue,**/*.svelte
Exclude: node_modules/**, dist/**, build/**, .next/**, coverage/**, *.min.*, *.d.ts, _generated/**, .git/**
If path argument provided, scope discovery to that path.
Phases 2-5
Read ${CLAUDE_SKILL_DIR}/references/workflow.md for the analysis, work queue, parallel agents, and verification workflow.
Gotchas
- Generated files (
*.d.ts,_generated/, codegen output) get picked up by glob patterns. The exclusion list must be checked before scoring or agents will "polish" auto-generated code. - Polishing test files can silently break assertions. Renaming variables, simplifying ternaries, or removing "dead" setup code in tests often changes behavior. Score test files conservatively.
- Agents run in parallel and can conflict if two files import from each other. One agent renaming an export while another reads the old name causes build failures.
- 5 simultaneous agents on a large codebase can hit Claude rate limits. If agents start failing, reduce concurrency to 2-3.
Related Skills
ramonclaudio/search
tools
VerifiedTrustedCommunity
Search indexed reference codebases (Convex, Expo, Next.js, Better Auth, Remotion, etc) via the qmd MCP query tool. Use when looking up framework APIs, finding code examples in third-party repos, or answering questions about external libraries that aren't in the current working directory.
4SKILL.mdUpdated Apr 24, 2026
ramonclaudio/add
development
VerifiedTrustedCommunity
Adds a reference collection to qmd. Accepts a GitHub URL, owner/repo shorthand, or a local directory path. Auto-detects file types, sets ignore globs, indexes with AST chunking, embeds, and verifies. Use when adding a new reference codebase or local notes folder for search.
4SKILL.mdUpdated Apr 24, 2026
ramonclaudio/plugins/techdebt/skills/techdebt
tools
VerifiedTrustedCommunity
--- name: techdebt description: Lightweight end-of-session tech debt sweep. Finds duplicated code, dead exports, unused deps, stale TODOs, and bloated files. Use when user asks for "tech debt", "cleanup", "dead code", "unused exports", "code sweep", or end-of-session hygiene. Do NOT use for full codebase audits (use /audit instead). argument-hint: [--dry-run] [path/to/scope] context: fork agent: general-purpose allowed-tools: - Read - Edit - Glob - Grep - Bash(git *) - Bash(wc *) -
3SKILL.mdUpdated Apr 24, 2026
ramonclaudio/teams
development
VerifiedTrustedCommunity
Use this skill when the user asks to orchestrate a team, use multiple agents, or parallelize work across Claude Code sessions. Decomposes tasks, spawns teammates, and coordinates execution.
3SKILL.mdUpdated Apr 24, 2026