using-agent-skills

by addyosmani107k

Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all ot

Install

Use withClaudeCursorCodex

The file stays in the publisher's repository. PlugMCP does not host or rewrite it.

Download skill skills/using-agent-skills/SKILL.md on GitHub

Related skills

View all

agent-skillsProduction-grade engineering skills for AI coding agents.
api-and-interface-designGuides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or es
browser-testing-with-devtoolsTests in real browsers via Chrome DevTools MCP. Use when building or debugging anything that runs in a browser. Use when you need to inspect the DOM, capture console errors, analyze network requests,

name: using-agent-skills description: Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.

Using Agent Skills

Overview

Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.

Skill Discovery

When a task arrives, identify the development phase and apply the corresponding skill:

Task arrives
    │
    ├── Don't know what you want yet? ──────→ interview-me
    ├── Have a rough concept, need variants? → idea-refine
    ├── New project/feature/change? ──→ spec-driven-development
    ├── No quality bar written down? ──→ constraint-driven-development
    ├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
    ├── Implementing code? ────────────→ incremental-implementation
    │   ├── UI work? ─────────────────→ frontend-ui-engineering
    │   ├── API work? ────────────────→ api-and-interface-design
    │   ├── Need better context? ─────→ context-engineering
    │   ├── Need doc-verified code? ───→ source-driven-development
    │   └── Stakes high / unfamiliar code? ──→ doubt-driven-development
    ├── Writing/running tests? ────────→ test-driven-development
    │   └── Browser-based? ───────────→ browser-testing-with-devtools
    ├── Something broke? ──────────────→ debugging-and-error-recovery
    ├── Reviewing code? ───────────────→ code-review-and-quality
    │   ├── Too complex? ─────────────→ code-simplification
    │   ├── Security concerns? ───────→ security-and-hardening
    │   └── Performance concerns? ────→ performance-optimization
    ├── Committing/branching? ─────────→ git-workflow-and-versioning
    ├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
    ├── Deprecating/migrating? ────────→ deprecation-and-migration
    ├── Writing docs/ADRs? ───────────→ documentation-and-adrs
    ├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
    └── Deploying/launching? ─────────→ shipping-and-launch

Phase	Skill	One-Line Summary
Define	interview-me	Surface what the user actually wants before any plan, spec, or code exists
Define	idea-refine	Refine ideas through structured divergent and convergent thinking
Define	spec-driven-development	Requirements and acceptance criteria before code
Plan	planning-and-task-breakdown	Decompose into small, verifiable tasks
Build	incremental-implementation	Thin vertical slices, test each before expanding
Build	source-driven-development	Verify against official docs before implementing
Build	doubt-driven-development	Adversarial fresh-context review of every non-trivial decision
Build	context-engineering	Right context at the right time
Build	frontend-ui-engineering	Production-quality UI with accessibility
Build	api-and-interface-design	Stable interfaces with clear contracts
Verify	test-driven-development	Failing test first, then make it pass
Verify	browser-testing-with-devtools	Chrome DevTools MCP for runtime verification
Verify	debugging-and-error-recovery	Reproduce → localize → fix → guard
Review	code-review-and-quality	Five-axis review with quality gates
Review	code-simplification	Preserve behavior while reducing unnecessary complexity
Review	security-and-hardening	OWASP prevention, input validation, least privilege
Review	performance-optimization	Measure first, optimize only what matters
Ship	git-workflow-and-versioning	Atomic commits, clean history
Ship	ci-cd-and-automation	Automated quality gates on every change
Ship	deprecation-and-migration	Remove old systems and migrate users safely
Ship	documentation-and-adrs	Document the why, not just the what
Ship	observability-and-instrumentation	Structured logs, RED metrics, traces, symptom-based alerts
Ship	shipping-and-launch	Pre-launch checklist, monitoring, rollback plan

using-agent-skills

Install

Related skills

name: using-agent-skills description: Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.

Using Agent Skills

Overview

Skill Discovery

Core Operating Behaviors

1. Surface Assumptions

2. Manage Confusion Actively

3. Push Back When Warranted

4. Enforce Simplicity

5. Maintain Scope Discipline

6. Verify, Don't Assume

Failure Modes to Avoid

Skill Rules

Lifecycle Sequence

Quick Reference