mblode/agent-skills

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

• codebase-architecture: Design a structure, deepen an existing one, or harden it with guardrails.
• scaffold-nextjs: Next.js turborepo with Blode UI, Ultracite, GitHub, and Vercel.
• scaffold-cli: TypeScript CLI package: ESM, tsdown, vitest, changesets, CI.
• multi-tenant-architecture: Tenant isolation, routing, and custom domains on Cloudflare or Vercel.

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.

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: 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