GitHub - mblode/agent-skills: Nobody ships AI slop on purpose. These skills make sure you don’t.

GitHub

3 min read Original article ↗

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

Writing

  • eli5: Session talk in plain language: optional analogy, exact technical terms, and house vocabulary without forced templates.
  • ghostwriter: Writes anything as you or as your company: messages, posts, PRs, tickets, PRDs, design docs, slides, copy, docs, READMEs. Works with no profile and writes one from pasted samples.

Quality

  • 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.
  • test-audit: Prunes low-value tests to a measured target with coverage held, and gates new tests before they land.

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), 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: Measures a pipeline's critical path as median and p90 over runs, then splits, shards, trims setup, and shares test module state, with a ledger and trend.

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