skills.rest
baagad-ai
baagad-aiCOMMUNITY
Explore all skills by this author →
GitHub

code-surgeon

Analyzes GitHub issues and plain-text requirements to produce structured plans and per-task prompts.

1|Updated Feb 12, 2026
Search Tags:#planning#risk-assessment#code-analysis#ai-assistant#multi-file#surgical-prompts
One-click install
npx skills add https://github.com/baagad-ai/code-surgeon --skill code-surgeon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-surgeon
Source: https://github.com/baagad-ai/code-surgeon/tree/main
Command: npx skills add https://github.com/baagad-ai/code-surgeon --skill code-surgeon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

code-surgeon translates ambiguous requirements and GitHub issues into precise, executable plans and surgical prompts, enabling rapid, safe multi-file changes.

Core Features & Use Cases

  • Four modes: Discovery, Review, Optimization, Implementation Planning, plus a surgical-prompt-generation step
  • File-by-file prompts, risk assessment, and breaking-change detection to guide changes
  • Token-budget aware, resumable analysis with plan generation and structured outputs

Quick Start

Run /code-surgeon with a clear requirement to generate an implementation plan and surgical prompts.

Frequently Asked Questions about code-surgeon

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

FAQPage Schema
How do I turn GitHub issues into actionable implementation plans?▼

For multi-file code changes, the tool performs risk assessment and breaking-change detection, then generates file-by-file surgical prompts to guide precise edits across your codebase safely.

Can I analyze large codebases without exceeding token limits?▼

Yes, you can analyze large codebases without exceeding token limits because the tool uses token-budget aware, resumable analysis to process requirements and generate structured plans incrementally.

What modes are used for analyzing ambiguous software requirements?▼

Analyzing ambiguous software requirements uses four modes: Discovery, Review, Optimization, and Implementation Planning, which route the problem to produce structured plans and surgical prompts.

How do I generate per-file prompts for complex code edits?▼

To generate per-file prompts for complex code edits, you run the tool with a plain-text requirement to trigger the surgical-prompt-generation step, which outputs interactive.json with actionable file-by-file tasks.

Does code-surgeon work with plain-text requirements or only GitHub issues?▼

Code-surgeon works with both GitHub issues and plain-text requirements, translating either input into executable plans and surgical prompts for rapid, safe multi-file code changes.

Related Skills

Explore More Software Engineering Skills→
VIPER-MetricsVIPER-Metrics
1

feature-planner

Plan GitHub feature requests into implementation plans with architecture and testing steps.

Official
Advanced
GQAdonisGQAdonis

evolve-plan

Generate a prioritized improvement plan from assessment.json and optional analysis.json.

Community
Intermediate
TECHKNOWMAD-LABSTECHKNOWMAD-LABS

diff-generator

Generate unified diffs between file snapshots and current states.

Official
Intermediate
shinnytechshinnytech

llm-docs-optimizer

Optimize project documentation and README files for AI coding assistants.

Official
Advanced