agent-skills

My personal agent toolkit — the skills and starters I use to make coding agents genuinely useful. Compatible with the Agent Skills open standard.

Environment

This toolkit is installed and kept current as part of my machine setup in williamw/dotfiles, which clones this repo to ~/Developer/agent-skills, installs these local skills, uses manage-skills for curated third-party skills, and installs the gh wt extension.

Skills

Reusable, individually installable via npx skills:

Workflow & Toolkit

Skill	Description
favorite-skills	Runtime router and workflow guide for Bill's preferred skill stack.
grill-bill	Front door for build/change work that writes one approved plan to .agents/plans/.
manage-skills	Install, sync, audit, and diagnose the curated global skill pack.

Git

Skill	Description
git-commit	Iterative commit-then-verify workflow for making changes with focused commits.
git-draft-pr	Create or update GitHub pull requests with a safe draft-and-review workflow.
git-rebase	Rebase a feature branch onto main and resolve conflicts deliberately.
git-worktree	Create isolated git worktrees from bare-repo layouts for parallel work.
git-resolve-pr	Track and resolve PR review feedback with plan updates and supporting diffs.
git-case-sensitivity-fix	Fix macOS git failures caused by filename-only case changes.
git-code-audit	Audit files or directories through git history to explain risks and ownership.

Design & UI

Skill	Description
ui-polish	Polish UI feel through motion, easing, micro-interactions, and animation details.
nielsen-heuristics	Apply Jakob Nielsen's 10 usability heuristics across planning, implementation, and verification.
design-qa	Review UI quality for accessibility, readability, consistency, and visual errors.
inspect-rendered-ui	Inspect rendered pages with screenshots, HTML, accessibility trees, and JavaScript.
annotate-ui	Collect visual UI feedback by staging pages for boxed comments and annotations.
prototyping-workflow	Create single-file HTML prototypes for UI, marketing, docs, diagrams, or demos.
diagram-maker	Generate professional SVG stack, grid, and workflow diagrams with a configurable theme.

Writing & Code

Skill	Description
avoid-ai-writing	Edit prose to remove tell-tale AI writing patterns and make it direct.
coding-style	Write or refactor code into readable, story-like TypeScript in a Kent Beck spirit.

Install:

npx skills add williamw/agent-skills -s favorite-skills -s manage-skills -g -a cursor -y
npx skills add williamw/agent-skills -s grill-bill -s git-commit
npx skills add williamw/agent-skills --all

Starters

Related starter repos:

Starter	Description
assistant-agent	A personal work assistant that reads Slack, Linear, Notion, GitHub, and Google Workspace into a structured LLM wiki + dashboard. Open the repo and follow its setup flow from README.md / SETUP.md.

---