Back to Discover

agent-skills

skill

mblode

Skills for shipping better software.

View on GitHub
78 starsMITSynced Aug 17, 2026

Install to Claude Code

/plugin marketplace add mblode/agent-skills

README

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

Rendered live from mblode/agent-skills's GitHub README — not stored, always reflects the source repo.

0 Plugins

No plugins listed in this repo's manifest.

0 Comments

Login required
Log in to post a comment or update on this repo.

No comments yet — be the first to share an update.