Generates a research-grounded execution plan for a coding task. MUST BE USED whenever the user asks for a plan, design, architecture, or spec — including in plan/approval mode, BEFORE any plan is presented for approval. Reads the project, runs MANDATORY web research (surf-search-normal / surf-ai via Bash; falls back to WebSearch/WebFetch when Bash is blocked), interviews the user with research-backed options, and only then delivers a plan with cited sources and a research ledger. For vague, high-stakes, or hard-to-reverse work — or when the user explicitly says "raise all my doubts first", "exhaustive plan", "don't start until everything is clear", "levante todas as dúvidas", "plano exaustivo" — the skill automatically switches into its Deep mode: a full ambiguity sweep before any question is asked. Triggers on "make a plan", "plan this", "design…", "architect…", "spec this out", "what's the best way to…", "faça um plano", "planeje isso", "monte um plano", "arquitete". Do NOT use for trivial one-line edits — only when the task warrants a written plan (≥30 min implementation, ≥3 files, or any architectural decision).
Surf Plan Agent Skill includes pricing or quota commentary; 10 code blocks for direct copy-paste. At roughly 4,890 words the SKILL.md is on the longer end of the catalog distribution.
Surf Plan Agent Skill sits in the Science & Research category under the research-methods sub-topic in the ClaudSkills catalog. There are 10 related skills indexed alongside it; comparing a few before installing usually reveals which fits your workflow best.
Is Surf Plan Agent Skill safe to install?
A free static scan against the OWASP Agentic Skills Top 10 found no risk patterns in Surf Plan Agent Skill’s SKILL.md — no data-exfiltration, prompt-injection, or unexpected-execution signatures. The full security scan is below.
Installing & verifying
Installing Surf Plan Agent Skill writes its SKILL.md to ~/.claude/skills/surf-plan-agent-skill/SKILL.md; Claude Code discovers it automatically on the next session — no restart flag needed. It declares no allowed-tools restriction, so it inherits your session’s existing tool access rather than narrowing it. To confirm it loaded, ask Claude to list its available skills — surf-plan-agent-skill should appear by name.
What Surf Plan Agent Skill needs to run
External services
The SKILL.md references pricing, quota, or rate limits — it likely calls a paid or rate-limited API. Check the source before wiring it into unattended automation.
Worked code
10 copy-paste code blocks in the body.
Depth
~4,890 words, substantial — top of the catalog distribution.
When to reach for it
There are 10 related skills in Science & Research — a two-minute scan of the alternatives usually confirms whether Surf Plan Agent Skill is the right pick.
These notes are auto-generated from features detected in the SKILL.md file and from this catalog's structure — they aren't part of the source repository.
From the source SKILL.md
You are the agent the user is talking to. When the user asks for a plan (see triggers in the frontmatter), you follow this workflow — but not always the same amount of it. Every plan is research-grounded; only some plans also need a full ambiguity sweep first. The Mode Decision phase below tells you which one this request needs. Skipping phases within your chosen mode is forbidden. This skill exists because plans that skip web research go stale fast, plans that skip project discovery recommend things the codebase already has, and plans built on an unspoken assumption fail exactly where the…
What this skill does
Surf Plan Agent Skill is a community-contributed Claude Code skill in the research-methods sub-category. It ships as a SKILL.md file that Claude Code auto-discovers under ~/.claude/skills/surf-plan-agent-skill/ and loads when your prompt matches the skill's trigger.
Who uses this skill
The Surf Plan Agent Skill Claude Code skill is built for researchers, data scientists, academics, and analysts working with complex data and scientific literature. It's part of ClaudSkills (also referred to as Claude Skills or Claude Code Skills) — the open community-curated registry of 191,000+ SKILL.md files for Anthropic's Claude Code agent and the wider Claude ecosystem (Claude API, Claude Agent SDK).
Or just download SKILL.md directly and drop it into ~/.claude/skills/surf-plan-agent-skill/. Claude Code auto-discovers it on next session.
Skills live at ~/.claude/skills/surf-plan-agent-skill/SKILL.md on macOS/Linux, or %USERPROFILE%\.claude\skills\surf-plan-agent-skill\SKILL.md on Windows. See the full install guide for step-by-step instructions.
Telegram
📱 Install from your phone or desktop Telegram
Open @claudskills_bot on Telegram, tap Open Desktop App, and the desktop app installs this skill for you. Or share the bot link with a colleague — they get the same one-tap install. Learn more →
Pro
One-click install via the desktop app
The ClaudSkills desktop app installs any skill directly into ~/.claude/skills/ with one click — no terminal required. Pro starts at $9/mo or $149 lifetime.
Pro
For the full experience including quality scoring and one-click install features for each skill — upgrade to Pro.
How do I install the Surf Plan Agent Skill Claude Code skill?
Install via the ClaudSkills desktop app (one click) or copy SKILL.md from the source repository to ~/.claude/skills/surf-plan-agent-skill/SKILL.md and restart Claude Code. Both flows are detailed at claudskills.com/install/.
What does the Surf Plan Agent Skill skill do?
Generates a research-grounded execution plan for a coding task. MUST BE USED whenever the user asks for a plan, design, architecture, or spec — including in plan/approval mode, BEFORE any plan is presented for approval. Reads the project, runs MANDATORY web research (surf-search-normal / surf-ai via Bash; falls back to WebSearch/WebFetch when Bash is blocked), interviews the user with research-backed options, and only then delivers a plan with cited sources and a research ledger. For vague, high-stakes, or hard-to-reverse work — or when the user explicitly says "raise all my doubts first", "exhaustive plan", "don't start until everything is clear", "levante todas as dúvidas", "plano exaustivo" — the skill automatically switches into its Deep mode: a full ambiguity sweep before any question is asked. Triggers on "make a plan", "plan this", "design…", "architect…", "spec this out", "what's the best way to…", "faça um plano", "planeje isso", "monte um plano", "arquitete". Do NOT use for trivial one-line edits — only when the task warrants a written plan (≥30 min implementation, ≥3 files, or any architectural decision).
Is this skill free to install?
Yes. ClaudSkills is an open registry — every skill keeps its source repository's license, and manual install via copy is free. ClaudSkills Pro ($9/mo, $79/yr, or $149 one-time) adds one-click install via the desktop app and a multi-signal Quality Score.
When should I use the Surf Plan Agent Skill skill?
Use Surf Plan Agent Skill when your Claude Code task falls under the Science & Research category — specifically in the research methods area. Claude Code auto-discovers installed skills and invokes the right one based on the task description, so you can also ask Claude directly (e.g. "use Surf Plan Agent Skill" or describe the task and let Claude pick). Browse related skills at /category/science/.
What is a Claude Code skill and how does the Surf Plan Agent Skill skill fit in?
A Claude Code skill is a SKILL.md file that lives under ~/.claude/skills/<name>/ and tells the Claude Code CLI agent how to perform a specific task (instructions, prompts, allowed tools). Skills are auto-discovered at session start. Surf Plan Agent Skill is one of 67,000+ skills indexed in the open ClaudSkills catalog, classified under the Science & Research category. Learn more at /learn/what-is-a-claude-skill/.
@misc{surf-plan-agent-skill-2026,
author = {frederico-kluser},
title = {Surf Plan Agent Skill [Claude Code skill]},
year = {2026},
publisher = {ClaudSkills},
url = {https://claudskills.com/skills/surf-plan-agent-skill/}
}
Embed this skill
Promote, attribute, or link this skill from your own README, blog post, or documentation. All three snippets are free to use — no sign-up, no API key. More distribution surfaces →
Claude™ is a trademark of Anthropic PBC. ClaudSkills (also referred to as Claude Skills or Claude Code Skills Catalog) is an independent community-curated registry of SKILL.md files, not affiliated with, endorsed by, or sponsored by Anthropic.
Install ClaudSkills — browse 70k+ skills offline, one tap from your home screen.