skills for everythingAgent Skill
2/7/2026preview
Display execution plan preview before running commands, allowing user confirmation or modification.
B
benjaminrose805
0GitHub Stars
2Views
npx skills add BenjaminRose805/react-basecamp
SKILL.md
| Name | preview |
| Description | Display execution plan preview before running commands, allowing user confirmation or modification. |
name: preview description: Display execution plan preview before running commands, allowing user confirmation or modification.
Preview Skill
Display execution plan preview before running commands, allowing user confirmation or modification.
Mode Check
CRITICAL: Check mode before displaying preview.
if (mode === "basic") {
// Skip preview entirely
// Execute command immediately
return;
}
// Continue with preview display
When Used
| Command | Preview Content |
|---|---|
/start | Worktree path, branch name, next steps |
/design | Mode (define/reconcile), phases, sub-agents |
/implement | Spec reference, stages, agents, TDD phases |
/ship | Commit, PR, CI, CodeRabbit stages |
NOT used by: /start (quick operation), /research (informational)
Preview Data Structure
interface ExecutionPreview {
// Command context
command: string; // Original command (e.g., "/implement login form")
detected: string; // What was detected (e.g., "Frontend component")
scope: string; // Scope description (e.g., "Login form UI")
// Routing info
route: {
type: "agent" | "workflow";
name: string; // Agent or workflow name
reason: string; // Why this route was chosen
};
// Execution plan
stages: Stage[];
// Metadata
tools: string[]; // MCP servers/CLI tools that will be used
flags?: string[]; // Any flags that modify behavior
}
interface Stage {
number: number;
name: string; // e.g., "RESEARCH", "BUILD", "VERIFY"
agent?: string; // Agent handling this stage
subAgents: SubAgentPlan[];
status: "pending" | "conditional"; // conditional = depends on prior stage
}
interface SubAgentPlan {
name: string; // e.g., "ui-researcher"
model: "Opus" | "Sonnet" | "Haiku";
tasks: string[]; // Planned tasks
parallel?: boolean; // True if runs in parallel with siblings
}
Display Formats
/start Preview
┌─────────────────────────────────────────────────────────────────┐
│ /start user-authentication │
├─────────────────────────────────────────────────────────────────┤
│ Creating new workspace for: user-authentication │
│ │
│ ACTIONS │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ 1. CREATE WORKTREE ││
│ │ Path: ../project-user-authentication ││
│ │ Branch: feature/user-authentication ││
│ │ ││
│ │ 2. NEXT STEPS ││
│ │ → Restart session in new worktree ││
│ │ → Run /design to begin designing ││
│ └─────────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────────┘
/design Preview (Define Mode)
┌─────────────────────────────────────────────────────────────────┐
│ /design user-authentication │
├─────────────────────────────────────────────────────────────────┤
│ Mode: Define │
│ Feature: User authentication with email/password │
│ │
│ PHASES │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ 1. RESEARCH domain-researcher Opus ││
│ │ □ Search existing auth patterns ││
│ │ □ Check for conflicts ││
│ │ □ Identify integration points ││
│ ├─────────────────────────────────────────────────────────────┤│
│ │ 2. WRITE domain-writer Sonnet ││
│ │ □ Create requirements.md (EARS format) ││
│ │ □ Create design.md (architecture) ││
│ │ □ Create tasks.md (phased work items) ││
│ ├─────────────────────────────────────────────────────────────┤│
│ │ 3. VALIDATE quality-validator Haiku ││
│ │ □ Verify EARS compliance ││
│ │ □ Check acceptance criteria ││
│ └─────────────────────────────────────────────────────────────┘│
│ │
│ Output: specs/user-authentication/ │
└─────────────────────────────────────────────────────────────────┘
/design Preview (Reconcile Mode)
┌─────────────────────────────────────────────────────────────────┐
│ /design (reconcile PR #42) │
├─────────────────────────────────────────────────────────────────┤
│ Mode: Reconcile │
│ PR: #42 - Add user authentication │
│ CodeRabbit comments: 3 │
│ │
│ ISSUES TO ADDRESS │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ 1. [Security] Use bcrypt, not SHA256 ││
│ │ 2. [Performance] Add index on email column ││
│ │ 3. [Style] Use early returns in validatePassword() ││
│ └─────────────────────────────────────────────────────────────┘│
│ │
│ PHASES │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ 1. ANALYZE domain-researcher Opus ││
│ │ □ Review each CodeRabbit comment ││
│ │ □ Identify affected files ││
│ │ □ Assess fix complexity ││
│ ├─────────────────────────────────────────────────────────────┤│
│ │ 2. PLAN domain-writer Sonnet ││
│ │ □ Create fix plan with tasks ││
│ │ □ Prioritize by severity ││
│ └─────────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────────┘
/implement Preview
┌─────────────────────────────────────────────────────────────────┐
│ /implement user-authentication │
├─────────────────────────────────────────────────────────────────┤
│ Spec: specs/user-authentication/ (approved) │
│ Tasks: 12 across 4 phases │
│ TDD: Enabled (red → green → refactor) │
│ │
│ STAGE 1: DATABASE SCHEMA │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ Agent: code-agent ││
│ │ ││
│ │ 1. RESEARCH code-researcher Opus ││
│ │ □ Find existing DB patterns ││
│ │ 2. TDD-RED code-writer Sonnet ││
│ │ □ Write failing tests ││
│ │ 3. TDD-GREEN code-writer Sonnet ││
│ │ □ Implement to pass tests ││
│ │ 4. VALIDATE quality-validator Haiku ││
│ │ □ Verify tests pass ││
│ └─────────────────────────────────────────────────────────────┘│
│ │
│ STAGE 2: AUTH API │
│ └─ [Same pattern with code-agent] │
│ │
│ STAGE 3: UI COMPONENTS │
│ └─ [Same pattern with ui-agent] │
│ │
│ STAGE 4: FINAL VERIFICATION │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ Agent: check-agent (parallel) Haiku ││
│ │ ⊕ build-checker ││
│ │ ⊕ type-checker ││
│ │ ⊕ lint-checker ││
│ │ ⊕ test-runner ││
│ │ ⊕ security-scanner ││
│ └─────────────────────────────────────────────────────────────┘│
│ │
│ Tools: cclsp, context7, next-devtools │
└─────────────────────────────────────────────────────────────────┘
/ship Preview
┌─────────────────────────────────────────────────────────────────┐
│ /ship │
├─────────────────────────────────────────────────────────────────┤
│ Feature: user-authentication │
│ Branch: feature/user-authentication │
│ Changes: 8 files, +342 -12 │
│ │
│ STAGES │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ 1. COMMIT ││
│ │ Agent: git-agent ││
│ │ ├─ change-analyzer (Sonnet) - Generate message ││
│ │ └─ git-executor (Haiku) - Create commit ││
│ ├─────────────────────────────────────────────────────────────┤│
│ │ 2. CREATE PR ││
│ │ Agent: git-agent ││
│ │ ├─ pr-analyzer (Sonnet) - Generate description ││
│ │ └─ git-executor (Haiku) - Create PR via gh CLI ││
│ ├─────────────────────────────────────────────────────────────┤│
│ │ 3. WAIT FOR CI ││
│ │ □ Monitor GitHub Actions ││
│ │ □ Report pass/fail ││
│ ├─────────────────────────────────────────────────────────────┤│
│ │ 4. WAIT FOR CODERABBIT ││
│ │ □ Monitor CodeRabbit review ││
│ │ □ Report comments or approval ││
│ └─────────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────────┘
User Confirmation
After rendering the preview box, use AskUserQuestion tool to confirm execution:
// 1. Call AskUserQuestion tool
AskUserQuestion({
questions: [
{
question: `Execute /${command}?`,
header: "Run",
options: [
{ label: "Run", description: "Execute the plan as shown" },
{ label: "Cancel", description: "Abort without executing" },
],
multiSelect: false,
},
],
});
// 2. Check user's response before proceeding
// If user selected "Cancel", STOP execution immediately.
// Only proceed with command execution if user selected "Run".
Automation Flag
Skip Preview with --yes
/implement --yes # Execute immediately without preview
/ship --yes # Ship without confirmation
/start auth --yes # Create worktree without preview
When --yes flag is present:
- Skip preview display
- Use default options
- Execute immediately
- Still show progress during execution
When to Use --yes
| Scenario | Recommended |
|---|---|
| CI/CD automation | Yes |
| Scripted workflows | Yes |
| Repetitive tasks | Yes |
| New/unfamiliar tasks | No |
| Complex features | No |
| Production changes | No |
Preview Generation
Algorithm
async function generatePreview(
command: string,
args: string
): Promise<ExecutionPreview> {
// 1. Parse command
const { type, target, flags } = parseCommand(command, args);
// 2. Route command
const routing = await route(type, target);
// 3. Build preview based on route type
if (routing.type === "agent") {
return buildAgentPreview(routing.agent, target);
} else {
return buildWorkflowPreview(routing.workflow, target);
}
}
function buildAgentPreview(agent: Agent, target: string): ExecutionPreview {
return {
command: `/${agent.command} ${target}`,
detected: agent.detectType(target),
scope: target,
route: {
type: "agent",
name: agent.name,
reason: agent.routingReason,
},
stages: agent.phases.map((phase) => ({
number: phase.order,
name: phase.name,
agent: agent.name,
subAgents: [
{
name: phase.subAgent,
model: phase.model,
tasks: phase.defaultTasks,
},
],
status: "pending",
})),
tools: agent.tools,
};
}
Error Handling
| Scenario | Handling |
|---|---|
| Routing fails | Show error, suggest alternatives |
| Spec not found | Show warning, proceed with keyword routing |
| Invalid edit input | Show validation error, re-prompt |
| User cancels | Exit gracefully, no execution |
| Preview generation fail | Fall back to simple text description |
Output
Preview Accepted
## Preview: ACCEPTED
Executing plan as shown...
(Switches to progress display)
Preview Edited
## Preview: MODIFIED
Changes:
- Scope: "login form" → "login form with 2FA"
- Skipped: research phase
Executing modified plan...
Preview Cancelled
## Preview: CANCELLED
No changes made.
Skills Info
Original Name:previewAuthor:benjaminrose805
Download