mblode/agent-skills

Nobody ships AI slop on purpose. These skills make sure you don't. 27 skills for UI audits, typography, docs, PR review, and releases.

Install

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

SKILL.md

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

27 on-demand skills for coding agents covering UI audits, typography, docs, PR review, and releases. Works with Claude Code and Codex.

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

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.

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: Boots the app in a headless browser and runs nine probes that turn inferred UI defects into measured ones, then proves the fix cleared.
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.

eli5: Session talk in plain language: optional analogy, exact technical terms, and house vocabulary without forced templates.
docs-writing: Diataxis doc types, 51 rules, audit and writing modes, agent-readable docs.
readme-creator: Type-aware README from the manifests: one install, a runnable quickstart, badges only where published.

ax-audit: Agentic experience audit: 27 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 audits and fixes, search-demand research, writer briefs, and search, AI visibility, and conversion measurement.

planning: Writes and reviews executable plans with repository evidence, vertical slices, and explicit acceptance criteria.
pr-reviewer: Read-only diff review: bugs, structure, AI slop, security.
tidy: Applies diff-scoped simplifications, preserving necessary guards and existing edits.
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.

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.