Agent Spec

Specify an autonomous or tool-using AI agent before building it. Use when asked to design an AI agent, define an agent's tools and guardrails, scope what an agent is allowed to do, or write an agent spec/PRD. Produces an agent spec — goal & scope, tools with permissions, the control loop, guardrails & approval gates, memory, escalation/handoff, evaluation, and failure handling.

1,573 stars 281 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add mohitagw15856/pm-claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add mohitagw15856/pm-claude-skills --skill agent-spec
Manual install
git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git /tmp/pm-claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/pm-claude-skills/plugins/pm-ai/skills/agent-spec ~/.claude/skills/agent-spec

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Agent Spec Skill

An agent is a model plus tools plus a loop — and the danger lives in the tools and the loop, not the
model. This skill specifies an agent so its *authority is explicit*: what it can do, what needs a human
yes, and what happens when it's wrong. Scope and guardrails first; cleverness second.

> **Not quite this?** Use `agent-observability-spec` when the agent is in production and needs tracing and alerting.

## Required Inputs

Ask for these only if they aren't already provided:

- **Job to be done** — the outcome the agent owns, and the boundary of its authority.
- **Tools/actions** — what it can call (read APIs, write actions, code execution), and which are irreversible.
- **Autonomy level** — fully autonomous, propose-then-approve, or co-pilot.
- **Risk surface** — what's the worst thing a wrong action could do (spend money, send a message, delete data)?
- **Success definition & escalation** — how "done" is judged, and when it must hand off to a human.

## Output Format

### Agent Spec: [name]

**1. Goal & scope** — the job in one sentence; explicit non-goals and authority limits.

**2. Tools / actions** — a table; mark each action's reversibility and required permission.

| Tool | Purpose | Reversible? | Gate |
|---|---|---|---|
| search_kb | read context | yes | none |
| send_email | notify | **no** | **human approval** |
Read the full skill on GitHub

Details

Skill name
agent-spec
Path
plugins/pm-ai/skills/agent-spec/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the Agent Spec skill do?

Specify an autonomous or tool-using AI agent before building it. Use when asked to design an AI agent, define an agent's tools and guardrails, scope what an agent is allowed to do, or write an agent spec/PRD. Produces an agent spec — goal & scope, tools with permissions, the control loop, guardrails & approval gates, memory, escalation/handoff, evaluation, and failure handling.

How do I install the Agent Spec skill?

Claude Code plugin: /plugin marketplace add mohitagw15856/pm-claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Agent Spec popular?

It lives in mohitagw15856/pm-claude-skills, which has 1,573 GitHub stars and 281 forks, and is included in 1 curated skill list.

Related skills

Ab Test Planner

1.6k

mohitagw15856/pm-claude-skills

Diseña pruebas A/B estadísticamente rigurosas para características de producto, cambios de UI, flujos de onboarding y experimentos de precios. Úsalo cuando te pidan configurar un experimento, diseñar una prueba A/B, calcular tamaño de muestra o interpretar resultados de pruebas. Produce un plan de prueba completo con hipótesis, definición de variantes, tamaño de muestra, estimación de duración, métricas de seguridad y una guía de interpretación de resultados.

Testing & QAIn 1 list281

Ab Test Planner

1.6k

mohitagw15856/pm-claude-skills

प्रोडक्ट फ़ीचर, UI बदलाव, ऑनबोर्डिंग फ़्लो और प्राइसिंग प्रयोगों के लिए सांख्यिकीय रूप से कठोर A/B टेस्ट डिज़ाइन करें। जब कोई प्रयोग सेट करने, A/B टेस्ट डिज़ाइन करने, सैंपल साइज़ निकालने या टेस्ट के नतीजे समझाने को कहे, तब इसका उपयोग करें। परिकल्पना, वेरिएंट की परिभाषा, सैंपल साइज़, अवधि का अनुमान, गार्डरेल मेट्रिक और नतीजों की व्याख्या की गाइड के साथ एक पूरा टेस्ट प्लान तैयार करता है।

Testing & QAIn 1 list281

Accessible Travel Planner

1.6k

mohitagw15856/pm-claude-skills

Summarise what Accessible Travel Planner does in one line. Use when asked to [trigger phrases the user would say]. Produces [the concrete artifact].

Frontend & DesignIn 1 list281

Agent Spending Mandate

1.6k

mohitagw15856/pm-claude-skills

Write a spending mandate that lets an AI agent buy things for you within strict limits: what it may buy, from whom, up to how much per purchase and in total, until when, and what needs your yes. Use when asked to let my agent make purchases, set a budget for an AI shopping agent, allow agentic checkout, limit what my assistant can spend, or prepare for agent payments. Produces the mandate in plain words and as a structured block, the always-ask list and the review and revoke steps.

AI, LLMs & AgentsIn 1 list281

Agent Severance

1.6k

mohitagw15856/pm-claude-skills

Summarise what Agent Severance does in one line. Use when asked to [trigger phrases the user would say]. Produces [the concrete artifact].

AI, LLMs & AgentsIn 1 list281

AI Agent Reliability

1.6k

mohitagw15856/pm-claude-skills

Make an AI agent or automation reliable enough to trust — the tests, checks, and guardrails that catch its failures before they reach anything real. Use when asked how do I test my AI agent, make my automation reliable, my agent works sometimes, or how do I trust an AI workflow in production. Produces a map of where the agent can fail (bad input, hallucination, wrong tool call, edge cases, silent errors), the checks that catch each (validation, evals on real cases, human-in-the-loop gates, monitoring), a right-sized reliability plan scaled to the stakes, and a rollout that earns trust incremen

AI, LLMs & AgentsIn 1 list281

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.