Skip to content

Latest commit

 

History

287 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agent Skills

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

26 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 cursor -y

--agent takes a space-separated list. A comma-separated one is rejected whole as a single invalid name.

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

  • eli5: Session talk in plain language: one gist, one analogy, next action first, no AI prose.
  • 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.
  • seo-program: Keyword and prompt-volume research, writer briefs, AEO question maps, Search Console monitoring.

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 and AEO: sitemaps, metadata, structured data, llms.txt, 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: Sets a repo up for Claude Code, Codex and Cursor, then 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

About

Skills for shipping better software.

Topics

Resources

Stars

94 stars

Watchers

1 watching

Forks

Contributors

Languages