surf-plan-skill

Generate research-grounded coding execution plans with cited web sources.

3|1|Updated May 1, 2026
One-click install
npx skills add https://github.com/frederico-kluser/surf-skill --skill surf-plan-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: surf-plan-skill
Source: https://github.com/frederico-kluser/surf-skill/tree/main/skills/surf-plan-skill
Command: npx skills add https://github.com/frederico-kluser/surf-skill --skill surf-plan-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you turn an ambiguous coding request into a concrete, research-grounded implementation plan that reduces stale assumptions and rework.

Core Features & Use Cases

  • Project-first discovery: reads relevant project files and identifies existing patterns and constraints before making any recommendations.
  • Baseline web research with citations: performs required multi-angle web searches and produces a Markdown plan that cites sources for every key decision.
  • Clarifying questions only when needed: asks up to five user questions, each preceded by fresh targeted research, so scope and architecture match current best practices.

Quick Start

Tell your agent: "Make a plan for adding rate limiting to my Express API using current production best practices, and ask me the key architecture questions before you write the plan."

Frequently Asked Questions about surf-plan-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a research-backed execution plan for complex architectural changes?

Execution planning for architectural changes requires reading project files first, then performing fresh web research with citations to ground decisions and outputting a Markdown plan file that reduces stale assumptions and rework.

What is the best way to plan multi-file feature implementation using current best practices?

Planning multi-file features involves a fixed multi-phase workflow that enforces fresh targeted web research before asking clarifying questions, ensuring scope and architecture match current production best practices with cited sources.

Do I need a web search tool to generate a cited markdown plan for coding tasks?

Yes, generating a cited Markdown plan requires a web search tool dependency to perform the mandatory baseline and targeted searches that provide citations for every key architectural and security decision before writing the plan.

How does codebase discovery work before making security and performance decisions?

Codebase discovery works by reading relevant project files first to identify existing patterns and constraints, which grounds subsequent web research and ensures security and performance decisions fit the specific project.

Can I use this planning workflow for research-driven design requests?

Yes, this workflow applies to non-trivial implementation work including research-driven design requests, enforcing fresh targeted web searches before clarifying questions to align scope and architecture with current best practices.

Why does the planning agent ask clarifying questions during architectural planning?

The agent asks up to five clarifying questions during architectural planning, each preceded by fresh targeted research, to ensure the execution plan matches current best practices and eliminates ambiguous scope assumptions.