jmusick/skills

Agent skills I write and use with Claude Code, Codex, and other agents that support the Agent Skills format.
## Skills
| Skill | What it does |
| daily-budget | Sweeps Firelands Current's sources for new stories, events and images, drafts the best leads with newsroom, and builds a dated review packet for the editor. |
| design-taste | Audits, polishes, or checks web UI so it stops reading as AI-generated: the dated tells registry, the accessibility and typography floor, motion timing, and a two-round screenshot critique. |
| humanize | Rewrites or audits text so it stops reading as AI-generated, keeping the meaning and the writer's voice. |
| issue | Picks a GitHub issue, offers a cheaper model when the job is small, does the work in its own worktree, reviews it, updates the docs it affected, pauses for you to test it in local dev, bumps the version in the PR, squash-merges it as one vX.Y.Z release commit, tags it, cleans up its branches, and retitles the chat. |
| minor | Cuts a minor release: bumps X.Y.Z to X.Y+1.0, updates the changelog, commits, tags, and pushes. |
| music-creation | Writes, revises, and critiques songs, lyrics, melodies, and arrangements, prepares ready-to-paste Suno packages, and can plan an EP or album. |
| newsroom | Writes, edits, and checks news stories for Firelands Current in AP style, with house rules, story-type playbooks, and editor flags. |
| patch | Cuts a patch release: bumps X.Y.Z to X.Y.Z+1, updates the changelog, commits, tags, and pushes. |
| sprite | Makes pixel-art sprites for Chomp Chomp Panic!: generates each animation with Codex CLI's image tool from a structured prompt and a reference image, then snaps it onto the game's frame grid, palette and outline and writes the strips the Unity importer expects. Needs Codex CLI installed and logged in. |
| title | Renames the current chat session to match what actually happened in it. |
| update-docs | Audits README, AGENTS.md, CLAUDE.md, CHANGELOG, the privacy policy, and other docs against the code and fixes what's wrong or out of date, then finds contradictions, stale records, and docs to consolidate or delete, and proposes structural changes for approval. |
| wave | Picks a wave of non-overlapping GitHub issues, hands each to a subagent on the model and effort its size calls for, reviews every diff and updates the docs it affected, ships each issue one at a time as its own squash-merged, tagged vX.Y.Z release, and retitles the chat. |
## Install
With the skills CLI:
bash
npx skills add jmusick/skills
Or install one by hand by copying (or symlinking) its folder into your agent's skills directory:
bash
cp -r skills/humanize ~/.claude/skills/
Claude Code reads ~/.claude/skills/, Codex reads ~/.codex/skills/.
## Layout
skills/
SKILL.md # frontmatter (name, description) + instructions
scripts/ # optional helper scripts the skill runs
references/ # optional docs the skill loads on demand
evals/ # optional test cases for skill-creator or claude plugin eval
Each skill folder holds all of its own files, so it can be copied anywhere on its own. Some skills call another skill: daily-budget needs newsroom installed too. Issue and wave run update-docs on each change before it ships and title at the end of the run, so install those alongside them; without them, issue and wave check the docs by hand and leave the chat's title alone. They also fall back to patch and minor when a repo can't squash-merge or the user merges a PR themselves.