Tune And Polish — Development skill for Claude Code
Tunes triggers and boundaries with Tune-Skill, then polishes discovery with Findable-Polish — use it only when you want both halves at once.
How to install Tune And Polish
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open arm-pz/tune-and-polish and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Tune And Polish does
Tunes triggers and boundaries with Tune-Skill, then polishes discovery with Findable-Polish — use it only when you want both halves at once. A triggering-only fix belongs to tune-skill, a listing-only one to findable-polish. Not for creating skills (use draft-skill).
Alternatives in Development
- Tutti — Where people and agents build in tune 3.5k ★
- Magnitude — Open source inference server your agent sets up for you 1.5k ★
- Polish Phase.Skill — polish-phase.skill.md 265 ★
README
tune-and-polish
**Fix skill triggers and polish discoverability in one pass.**
When a skill isn't triggering correctly or overlaps with siblings, and you also want its public surfaces (repo description, README, site page) polished for discovery, tune-and-polish handles both. It runs Tune-Skill to diagnose trigger/boundary/handoff issues and make minimal validated edits, then passes the result to Findable-Polish to audit discoverability gaps and generate improved alternatives. You get a skill that fires correctly and is easy to find.
Usage
/tune-and-polish findable
/tune-and-polish ~/.qoder/skills/wordsmith/SKILL.md
Fix my skill's triggering and polish its discovery surfaces.
When to use
- You want both trigger fixes AND better discoverability in one pass
- A skill isn't triggering when it should and its listing needs the same attention
- Two skills claim the same request and you want the public copy updated after the split
- Someone says "this skill doesn't work and nobody finds it"
- You're preparing a skill for publication and want it tight
What it produces
- Trigger/boundary/handoff audit from Tune-Skill
- Minimal validated edits to SKILL.md
- check_skill.py validation (FAIL/WARN/PASS)
- Discoverability audit from Findable-Polish
- Polished alternatives for descriptions, README, site page
Install
npx skills add arm-pz/tune-and-polish
Dependencies
Requires `tune-skill` and `findable-polish` (which needs `findable` + `wordsmith`) to be installed.
Not for
- Creating skills from scratch → use draft-skill
- Just tuning without polishing → use tune-skill alone
- Just polishing without tuning → use findable-polish alone
Related
- tune-skill — Fix triggers and boundaries (phase 1)
- **[findable-polish](https://github.com/arm-pz/findable-p
Related Skills
Skill Launch
Launches one new skill from an idea: drafts with Draft-Skill, validates and tunes with Tune-Skill, then audits
Tune Skill
Agent skill that audits and fine-tunes a skill that already exists: triggering descriptions, sibling overlaps,
Agent Skill Description Optimizer
Optimizes the description frontmatter of a Claude Code / Agent Skill - the text that decides whether Claude in
Findable Polish
Audits content for discoverability gaps with Findable, then generates improved alternatives with Wordsmith. Us
Add Cron Railway
Create scheduled jobs on Railway using node-cron or external cron services. Implement cron scheduler in Expres
Plugin Tune Triggers
Sharpen a plugin's skill trigger descriptions so each fires exactly when it should
Related Agents
Bead Polisher
Polishes .beads/beads.jsonl in isolated context. Runs the full polish loop (self-containment, dependencies, te
LinkedIn Scraper
Use this sub-agent to orchestrate LinkedIn scraping for all qualified leads via Apify actors. Only ONE instanc
Brainstorm Agent
Design and architecture specialist. Triggers on 'design', 'architect', 'how should we build', 'brainstorm', 'h