One install chains two skills: Findable audits the surfaces people actually search — README opening, GitHub About text, topics, site page — against the task queries a stranger would type, and Wordsmith writes two or three alternatives per finding that fix it without inventing a fact. You get the diagnosis and the cure in one pass.
install
The install line from the repo README. This skill is a chain: findable and wordsmith must be installed too — if either is missing it says so and stops.
npx skills add arm-pz/findable-polish --skill findable-polish
the workflow
Phase one runs the Findable audit and hands its full report on, untouched — no summarising the evidence away. Phase two turns each finding into alternatives. Phase three returns everything in one copy-paste-ready block.
Findable reads the target content and derives the queries a stranger types, task-based, never name-based.
Wordsmith treats each audit finding as its own rewrite task, in the author's voice and facts.
One three-part response: audit summary by severity, alternatives grouped by issue, and a merge recommendation.
The chain stops where its parts begin. Tuning the SKILL.md description that carries agent triggering is tune-skill. Setting up a repo's discovery from scratch, with distribution targets, is findable. This skill writes human-facing copy from a real audit; it does not execute gh commands or push changes — it hands over the commands.
ground rules
Every rewrite is written from a search query a real stranger would type, derived and shown before any prose. Copy written from vibes gets audited again by the search engine, not by you.
Alternatives may not claim features, install counts or compatibility the content doesn't support. A rewrite that adds a false capability is a worse audit result, not a better one.
Phase two receives the full phase-one report verbatim. Summarising findings before rewriting them drops the awkward ones, and the awkward ones are the point.
Free, open, and every alternative traces back to a finding the audit named.
Install findable-polish Read the source