Skip to content

mblode/agent-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

162 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agent Skills

skills.sh

25 skills for shipping better software.

Quickstart

npx skills add mblode/agent-skills

Works with Claude Code, OpenCode, Codex, and Cursor.

Why these skills exist

Code review catches logic bugs. Nobody checks the loading states, the type scale, or whether half the diff is AI slop. These skills do.

Skills

Architecture

  • define-architecture: Folder structures, module contracts, and middleware pipelines for TypeScript apps, plus deepening existing codebases.
  • scaffold-nextjs: Scaffolds a Next.js turborepo with Blode UI, Ultracite tooling, GitHub setup, and Vercel deploy.
  • scaffold-cli: Scaffolds a TypeScript CLI/npm package: ESM, dual tsdown build, vitest, ultracite, changesets, GitHub Actions.
  • multi-tenant-architecture: Multi-tenant domain strategy, isolation, routing, custom domains, and plan mapping on Cloudflare or Vercel.

Design

  • ui-design: Designs and builds UI end to end: visual direction (palettes, type scales, tokens, CRO, brand kits), Tailwind implementation with the ui.sh design guidelines, multi-variant browser picker, screenshot-to-markup scaffolding, dark-mode and responsive retrofits, and componentization with Tailwind class cleanup.
  • ui-animation: Designs, implements, and reviews UI motion: springs, gestures, easing, CSS transition recipes.
  • reverse-engineer-animation: Extract easing, spring, and choreography from a screen recording and emit CSS, Motion, SwiftUI, RN, or UIKit code.
  • typography-audit: 90-rule typography audit: punctuation, fonts, sizing, spacing, OpenType, hierarchy, pairing.
  • presentation-creator: Dark-first slide decks with narrative arcs, speaker notes, investor pitch decks, and a QA pass.

Writing

  • copywriting: Short product and marketing copy; persuasion frameworks, seven sweeps, AI-ism removal, before/after diffs.
  • blog-post: Long-form blog posts (listicles, tutorials, narratives, thought leadership) with research, SEO, and polish.
  • docs-writing: Technical docs. Diataxis doc types, 52 rules, audit and writing workflows.
  • readme-creator: Writes or rewrites a README tailored to the project type, validated against quality checks.

Quality

  • ui-audit: Page-level web UI audit: 35 rules across a11y, forms, interaction, layout, perf, motion, and microcopy.
  • ux-audit: Feature-level UX audit for React/Next.js diffs. 63 rules, 12 playbooks, 3-tier ship verdict.
  • ax-audit: Agentic experience audit: 23 rules over architecture + trust layers, ship verdict, AX Relationship Summary.
  • optimise-seo: Next.js App Router SEO: sitemaps, metadata, structured data, hreflang, CWV, security headers, and resilience.

Shipping

  • plan-creator: Collaborative interrogation that produces a plan: explores code and docs first, one question at a time.
  • plan-reviewer: Adversarial plan review: scores six dimensions, verifies claims locally, writes fixes into the plan file.
  • pr-reviewer: Read-only review of your local diff: bugs, structural quality, AI slop, and on-request security audits.
  • pr-creator: Creates PRs with short human-sounding descriptions, Linear ID titles, commit restructuring, and reviewer guidance.
  • pr-babysitter: Autonomously monitors an open PR: conflicts, CI, review comments, merge readiness. Fixes what it can.
  • autoship: End-to-end npm releases with changesets: fix loop, CI watch, Version Packages merge, publish verify.

Authoring

  • agents-md: Audits, scores, and refactors AGENTS.md/CLAUDE.md: 10-check triage or 45-check full audit with grades.
  • agent-skills-creator: Skill creation and improvement following the open format spec.

License

MIT

About

Skills for shipping better software.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages