Agent Skills

Nobody ships AI slop on purpose. These skills make sure you don’t.

UI audits, typography, docs, PR review, and releases. On-demand skills for coding agents.

Install

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

If these help, star the repo so others find them.

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 (oxlint/shadcn), 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, design-system extraction, Tailwind builds, screenshot to markup, dark mode, responsive, and a React and Next.js UX audit with a ship verdict.
• ui-verification: Runs nine browser probes, reviews before/after captures and suspicious duplicate states, then proves the fix cleared.
• app-verification: Builds and maintains a product's own verify CLI, doctor command, feature map, and worktree isolation, with reusable API checks, checked flow cleanup, and a reproduce-first bug handoff. Call by name.
• ui-animation: Springs, gestures, easing, and curves pulled from a screen recording.
• presentation-creator: Decks with a story spine, speaker notes, and a contrast-checked QA pass, as Marp markdown, a web app, or a handoff to pptx.

Writing

• eli5: Explains in the form that fits: plain prose, controlled English modelled on ASD-STE100, diagrams, interactive HTML pages, or narrated explainer videos, with exact technical terms and house vocabulary.
• ghostwriter: Writes anything as you or as your company: messages, posts, review comments, tickets, PRDs, design docs, talk scripts, copy, docs, READMEs, with the AI tells stripped. Works with no profile, writes one from pasted samples, and learns from your edits.

Quality

• ax-audit: Agentic experience audit: 24 rules for tool parity, approval gates, and escape hatches, ship verdict.
• dx-audit: Libraries, CLIs, SDKs, npm packages: 38 rules, agent-friendly checks, root-cause findings.
• agent-ready: Implements AFDocs, Is Agentic, Is It Agent Ready, and agent 404 findings: llms.txt maps, markdown twins, API errors.
• typography-audit: 78 rules: punctuation, fonts, sizing, spacing, hierarchy, pairing.
• seo: SEO, AEO and GEO audits and fixes, search-demand research, writer briefs, and search, AI visibility, and conversion measurement.
• test-audit: Prunes low-value tests across a whole suite to a measured target with coverage held; invoked explicitly for a repo-wide or subsystem-wide campaign.

Shipping

• planning: Writes and reviews executable plans with repository evidence, vertical slices, and explicit acceptance criteria.
• tidy: Diff or PR review with file:line findings in confirmed and plausible tiers (bugs, structure, AI slop, security, new-test gating), report-only by default; apply mode lands the fixes and simplifies the diff.
• pr-creator: PRs with short human descriptions, Linear IDs, templates, drafts, tidied commits.
• pr-babysitter: Watches an open PR: conflicts, CI, comments. Fixes what it can.
• autoship: npm releases with changesets: fix loop, CI watch, Version Packages merge, OIDC publish verify.
• ci-speedup: Finds where changes wait from push to deploy, then fixes the critical path, check placement, merge queue or post-merge revert, flaky tests, and deploy rate, and installs an agentic merge loop on GitHub (no merge queue, post-merge bisect and revert, agent re-lands and repairs), with a ledger.

Authoring

• chat-history: Recover decisions, previous fixes, and context from past AI conversations with fast local search and source evidence.

• agents-md: Wires a repo so Claude Code, Codex and Cursor read the same instructions, migrates to native AGENTS.md without Claude wrappers, then audits and refactors instructions with grades.

• agent-skills-creator: Creates and audits skills by their added value, with portable workflows, a validator, and regression scenarios.

• save-md: Writes a named source as a markdown file the next turn can reread.

License

MIT

---

Crafted by Matthew Blode