Agent Skills

UI audits, typography, docs, PR review, and releases, loaded on demand by your coding agent

24 skills for the parts of shipping that code review never covers: the loading states, the type scale, and whether half the diff is AI slop.

Install

npx skills add mblode/agent-skills -g --agent claude-code,codex -y

The bundle is listed at skills.sh.

Agents: these skills. Humans: Taste Training, a course on spotting and fixing AI slop. First unit free.

Skills

Architecture

Design

  • product-design: What the interface should do, before anyone builds it.
  • ui-design: Visual direction, Tailwind builds, screenshot to markup, dark mode, responsive, and a React and Next.js UX audit with a ship verdict.
  • ui-animation: Springs, gestures, easing, and curves pulled from a screen recording.
  • presentation-creator: Decks with a story spine, speaker notes, and a QA pass, as markdown or a web app.

Writing

  • copywriting: Product and marketing copy, persuasion frameworks, brand voice charts, AI-ism removal.
  • docs-writing: Diataxis doc types, 48 rules, audit and writing modes.
  • readme-creator: Writes or rewrites a README as a public-facing shop window.

Personal voice, blog posts, and voice evaluation live in ghostwriter.

Quality

  • ax-audit: Agentic experience audit: 23 rules, ship verdict.
  • dx-audit: Libraries, CLIs, and SDKs: root-cause findings, agent-friendly checks.
  • typography-audit: 78 rules: punctuation, fonts, sizing, spacing, hierarchy, pairing.
  • optimise-seo: Next.js SEO: sitemaps, metadata, structured data, hreflang, CWV.

Shipping

  • planning: Builds the plan, then scores it to 5/5 before any code.
  • pr-reviewer: Read-only diff review: bugs, structure, AI slop, security.
  • tidy: Hunts complexity across five angles and applies the simplifications.
  • pr-creator: PRs with short human descriptions, Linear IDs, tidied commits.
  • pr-babysitter: Watches an open PR: conflicts, CI, comments. Fixes what it can.
  • autoship: npm releases with changesets: fix loop, CI watch, publish verify.

Authoring

  • agents-md: Audits and refactors AGENTS.md and CLAUDE.md, with grades.
  • agent-skills-creator: Creates and improves skills to the open format spec.
  • save-md: Writes a named source as a markdown file the next turn can reread.

License

MIT

Crafted by Matthew Blode