Search everything...

Stats

Actions

Available In

skills

Name: skills
Author: miguelspizza

By MiguelsPizza

Improves TypeScript codebases by inlining forwarding functions and guiding maintainability-focused cleanup, refactoring, and boundary enforcement. Also designs WebMCP instrumentation for SPAs and restructures documentation using the Diataxis framework.

npx claudepluginhub miguelspizza/skills --plugin skills

Popularity

Stars

Top 25%

Med: 0·Avg: 281

Installs

Med: 0·Avg: 1

What's Inside

Skills4

flatten-fake-layers

/flatten-fake-layers

Find and flatten "fake layer" indirection in a TypeScript codebase — functions with exactly one caller that only forward, reshape, or inject dependencies and add no fact. Runs a deterministic AST detector that flags candidates, then uses agent judgment to inline the real slop while keeping functions that do real work (type narrowing, throwing, validation, lifecycle). Use when asked to reduce over-abstraction, "un-slop" or simplify code, flatten dependency-injection ceremony, delete single-use wrappers, or clean up AI-generated indirection. Pairs with a goal/loop prompt to run iteratively across a codebase until clean.

maintainable-typescript

/maintainable-typescript

Guides maintainability-first cleanup, refactoring, and review in strict TypeScript repos and monorepos. Use when improving code health, deleting dead code, reducing duplication, or enforcing boundaries.

webmcp-designer

/webmcp-designer

Designs and reviews WebMCP instrumentation for existing web apps, especially SPAs. Use when adding agent-accessible tools, route maps, prompts, or WebMCP workflows to a React, Vue, Angular, or vanilla browser app, or when deciding whether WebMCP is the right fit.

write-good-docs

/write-good-docs

Write, review, and restructure useful documentation with Diataxis, audience-specific README patterns, and AI-writing trope cleanup. Use when creating docs, improving READMEs, reorganizing documentation, or editing prose for clarity.

Stats

Version1.0.0

LanguageJavaScript

Stars8

MaintenanceExcellent

Last CommitJun 14, 2026

AddedApr 3, 2026

Actions

View on GitHub View README Plugin Marketplace JSON

Own this plugin?

Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).

Available In

miguelspizza-skills8

README

Agent Opinions

Opinionated skills and tooling for making AI coding agents leave codebases more maintainable than they found them.

Repo Layout

Maintainable TypeScript is the strict TypeScript maintainability skill. Its source lives in skills/maintainable-typescript, and its uploadable archive lives at skills/maintainable-typescript.zip.
WebMCP Designer is a skill for designing WebMCP instrumentation on existing web apps. Its source lives in skills/webmcp-designer, and its uploadable archive lives at skills/webmcp-designer.zip.
Write Good Docs is a skill for writing, restructuring, and reviewing documentation with Diataxis, README templates, and AI-writing trope cleanup. Its source lives in skills/write-good-docs, and its uploadable archive lives at skills/write-good-docs.zip.
tooling/README.md documents the standalone TypeScript maintenance tooling templates.
AGENTS.md is the contributor guide for editing skill doctrine in this repo.
how-to-write-skill-guide/README.md is the reference copy of Anthropic’s skill-building guide.

Install

Vercel Skills CLI

npx skills add miguelspizza/skills

Or install one skill:

npx skills add miguelspizza/skills --skill maintainable-typescript
npx skills add miguelspizza/skills --skill webmcp-designer
npx skills add miguelspizza/skills --skill write-good-docs

Claude Code plugin

/plugin marketplace add miguelspizza/skills
/plugin install skills@miguelspizza-skills

Claude.ai standalone skill

Upload skills/maintainable-typescript.zip, skills/webmcp-designer.zip, or skills/write-good-docs.zip in Customize > Skills.

Build

./scripts/build-skill-archive.sh
./scripts/build-skill-archive.sh webmcp-designer
./scripts/build-skill-archive.sh write-good-docs
./scripts/build-skill-archive.sh all

Those commands regenerate one or more skill archives from the corresponding folders in skills/.

skills

Popularity

What's Inside

Confidence

README

Agent Opinions

Repo Layout

Install

Build

Similar Plugins

caveman

frontend-design

claude-mem

ui-design

Agent Opinions

Repo Layout

Install

Build

Popularity

Health & Quality

Similar Plugins

caveman

frontend-design

claude-mem

ui-design

marketing-skills

nanobanana