skill-deck

Deck Skill

Thin wrapper that routes pitch deck generation requests to the deck-agent.

Context Pointers

Reference (do not load eagerly):

• Path: .opencode/context/core/formats/subagent-return.md
• Purpose: Return validation
• Load at: Subagent execution only

Note: This skill is a thin wrapper. Context is loaded by the delegated agent, not this skill.

Trigger Conditions

This skill activates when:

Direct Invocation

• User explicitly runs /deck command
• User requests pitch deck generation in conversation

Implicit Invocation (during task implementation)

When an implementing agent encounters any of these patterns:

Plan step language patterns:

• "Generate pitch deck"
• "Create investor deck"
• "Build presentation for investors"
• "Make YC-style slides"
• "Create startup pitch"

Target mentions:

• "pitch deck"
• "investor presentation"
• "seed round slides"
• "fundraising deck"
• "touying pitch"

Task description keywords:

• "pitch deck generation"
• "investor slides"
• "startup presentation"
• "YC deck"

When NOT to trigger

Do not invoke for:

• Converting existing presentations (use skill-presentation)
• General slide conversion from PPTX (use skill-presentation)
• Document format conversions (use skill-filetypes)
• Creating non-investor presentation slides

---

Execution

1. Input Validation

Validate required inputs:

• At least one of: prompt (text description) OR source_path (file path)
• output_path - Optional, defaults based on input
• theme - Optional, defaults to "simple"
• slide_count - Optional, defaults to 10

# Validate at least one input source
if [ -z "$prompt" ] && [ -z "$source_path" ]; then
  return error "Either a prompt or source file path is required"
fi

# If source_path provided, validate it exists
if [ -n "$source_path" ] && [ ! -f "$source_path" ]; then
  return error "Source file not found: $source_path"
fi

# Convert source_path to absolute if relative
if [ -n "$source_path" ] && [[ "$source_path" != /* ]]; then
  source_path="$(pwd)/$source_path"
fi

# Determine output path if not provided
if [ -z "$output_path" ]; then
  if [ -n "$source_path" ]; then
    source_dir=$(dirname "$source_path")
    source_base=$(basename "$source_path" | sed 's/\.[^.]*$//')
    output_path="${source_dir}/${source_base}-deck.typ"
  else
    output_path="$(pwd)/pitch-deck.typ"
  fi
fi

# Convert output_path to absolute if relative
if [[ "$output_path" != /* ]]; then
  output_path="$(pwd)/$output_path"
fi

2. Context Preparation

Prepare delegation context:

{
  "prompt": "Startup description from user",
  "source_path": "/absolute/path/to/startup-info.md",
  "output_path": "/absolute/path/to/pitch-deck.typ",
  "theme": "simple",
  "slide_count": 10,
  "metadata": {
    "session_id": "sess_{timestamp}_{random}",
    "delegation_depth": 1,
    "delegation_path": ["orchestrator", "deck", "skill-deck"]
  }
}

3. Invoke Agent

CRITICAL: You MUST use the Task tool to spawn the agent.

Required Tool Invocation:

Tool: Task (NOT Skill)
Parameters:
  - subagent_type: "deck-agent"
  - prompt: [Include prompt, source_path, output_path, theme, slide_count, metadata]
  - description: "Generate pitch deck from input"

The agent will:

• Parse and validate inputs
• Read source file if provided
• Map content to YC's 10-slide structure
• Generate Typst code using touying
• Include speaker notes and TODO placeholders
• Return standardized JSON result

4. Return Validation

Validate return matches subagent-return.md schema:

• Status is one of: generated, partial, failed
• Summary is non-empty and <100 tokens
• Artifacts array present with output file path
• Metadata contains slide_count and slides_with_todos

5. Return Propagation

Return validated result to caller without modification.

---

Return Format

Expected successful return:

{
  "status": "generated",
  "summary": "Generated 10-slide pitch deck for Acme AI in Typst format. 2 slides have TODO placeholders.",
  "artifacts": [
    {
      "type": "implementation",
      "path": "/absolute/path/to/pitch-deck.typ",
      "summary": "Touying pitch deck with speaker notes"
    }
  ],
  "metadata": {
    "session_id": "sess_...",
    "agent_type": "deck-agent",
    "delegation_depth": 2,
    "theme": "simple",
    "slide_count": 10,
    "slides_with_todos": 2,
    "input_type": "prompt_and_file"
  },
  "next_steps": "Review and compile: typst compile pitch-deck.typ"
}

---

Error Handling

Input Validation Errors

Return immediately with failed status if neither prompt nor source file provided.

Source File Not Found

Return failed status with clear message about the missing file.

Agent Errors

Pass through the agent's error return verbatim.

Write Failure

Return failed status with directory/permission guidance.