Auto-Draft Skill

Overview

This skill is the main entry point for the Draftify auto-draft system. It coordinates the entire document generation workflow:

Phase 1-3.5: Invokes auto-draft-orchestrator agent for data collection, analysis, and section generation
Phase 4: Calls /draftify-ppt skill to generate the final PowerPoint document

Usage

bash

/auto-draft <URL> [options]

Required Arguments

Argument	Description
`URL`	Target MVP/mockup site URL to analyze

Optional Arguments

Option	Description	Default
`--prd <path>`	Path to PRD document	-
`--sdd <path>`	Path to SDD document	-
`--readme <path>`	Path to README file	-
`--screenshots <dir>`	Directory containing screenshots	-
`--source-dir <dir>`	Local source code directory	-
`--urls <file>`	Text file with additional URLs	-
`--output <dir>`	Output directory	`outputs/<project-name>/`
`--max-depth <n>`	Maximum crawling depth	`5`
`--max-pages <n>`	Maximum pages to crawl	`50`
`--record`	Enable Record mode for SPA	`false`

Workflow

/auto-draft invoked
    │
    ▼
┌─────────────────────────────────────┐
│ 1. Argument Validation              │
│    - Validate URL format            │
│    - Check file paths exist         │
│    - Set default values             │
└─────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────┐
│ 2. Invoke Orchestrator (Phase 1-3.5)│
│    - Task tool call                 │
│    - auto-draft-orchestrator agent  │
│    - Timeout: 25 minutes            │
└─────────────────────────────────────┘
    │
    │ Orchestrator returns:
    │ - projectName
    │ - outputDir
    │ - validation result
    │
    ▼
┌─────────────────────────────────────┐
│ 3. Call /draftify-ppt (Phase 4)     │
│    - Skill tool call                │
│    - Generate <project>-draft-V{version}.pptx      │
│    - Timeout: 10 minutes            │
└─────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────┐
│ 4. Return Results                   │
│    - Output file path               │
│    - Success/failure status         │
│    - Validation summary             │
└─────────────────────────────────────┘

Implementation

Step 1: Argument Validation

typescript

// Validate required URL
if (!url || !isValidUrl(url)) {
  throw new Error("Valid URL is required");
}

// Validate optional file paths
if (prd && !fileExists(prd)) {
  throw new Error(`PRD file not found: ${prd}`);
}

// Set defaults
const config = {
  url,
  prd: prd || null,
  sdd: sdd || null,
  readme: readme || null,
  screenshots: screenshots || null,
  sourceDir: sourceDir || null,
  urls: urls || null,
  output: output || null,
  maxDepth: maxDepth || 5,
  maxPages: maxPages || 50,
  record: record || false
};

Step 2: Invoke Orchestrator

typescript

const orchestratorResult = await Task({
  subagent_type: "general-purpose",
  description: "Execute auto-draft workflow Phase 1-3.5",
  prompt: `You are the auto-draft-orchestrator agent.

Read the orchestrator agent prompt from docs/design/agents/orchestrator.md.

**Configuration**:
${JSON.stringify(config, null, 2)}

Execute Phase 1-3.5 of the auto-draft workflow:
- Phase 1: Input collection (crawling + file reading)
- Phase 2: Analysis (input-analyzer)
- Phase 3-1: Prerequisite sections (policy + glossary, parallel)
- Phase 3-2: Dependent sections (screen → process, sequential)
- Phase 3.5: Quality validation

Return the project output directory path and validation result when complete.
  `,
  timeout: 1500000  // 25 minutes
});

Step 3: Call /draftify-ppt (Phase 4)

typescript

// Extract output directory from orchestrator result
const outputDir = orchestratorResult.outputDir;

// Call draftify-ppt skill for Phase 4
const pptResult = await Skill({
  skill: "draftify-ppt",
  args: outputDir
});

Step 4: Return Results

typescript

return {
  success: true,
  outputDir: outputDir,
  // Filename normalized from project metadata (spaces -> hyphens, lowercased)
  pptFile: `${outputDir}/${projectName}-draft-V${version}.pptx`,
  validation: orchestratorResult.validation
};

Note: projectName and version should be read from analyzed-structure.json to match the draftify-ppt filename normalization.

Error Handling

Orchestrator Failure

If Phase 1-3.5 fails:

Return partial results if any sections were generated
Include error message in response
Skip Phase 4 if no sections exist

PPT Generation Failure

If Phase 4 fails:

Return markdown sections as fallback
Attempt HTML generation as alternative
Include error message in response

Output Structure

Upon successful completion:

outputs/<project-name>/
+-- screenshots/
|   +-- *.png
+-- analysis/
|   +-- crawling-result.json
|   +-- analyzed-structure.json
+-- sections/
|   +-- 01-cover.md
|   +-- 02-revision-history.md
|   +-- 03-table-of-contents.md
|   +-- 04-section-divider.md
|   +-- 05-glossary.md
|   +-- 06-policy-definition.md
|   +-- 07-process-flow.md
|   +-- 08-screen-definition.md
|   +-- 09-references.md (optional)
|   +-- 10-eod.md
+-- validation/
|   +-- validation-report.md
+-- <project>-draft-V{version}.pptx    // Generated by /draftify-ppt

Timeout Budget

Phase	Duration	Component
Phase 1-3.5	25 min	Orchestrator
Phase 4	10 min	/draftify-ppt
Total	35 min

Examples

Basic Usage

bash

/auto-draft https://my-todo-app.com

With PRD Document

bash

/auto-draft https://my-todo-app.com --prd docs/prd.md

With Screenshots Only (No Crawling)

bash

/auto-draft https://my-todo-app.com --screenshots ./screens/

Full Options

bash

/auto-draft https://my-shop.com \
  --prd docs/prd.md \
  --sdd docs/sdd.md \
  --screenshots ./screens/ \
  --source-dir ./src/ \
  --max-pages 30

Search AI Tools

auto-draft

Install this agent skill to your Project

SKILL.md

Auto-Draft Skill

Overview

Usage

Required Arguments

Optional Arguments

Workflow

Implementation

Step 1: Argument Validation

Step 2: Invoke Orchestrator

Step 3: Call /draftify-ppt (Phase 4)

Step 4: Return Results

Error Handling

Orchestrator Failure

PPT Generation Failure

Output Structure

Timeout Budget

Examples

Basic Usage

With PRD Document

With Screenshots Only (No Crawling)

Full Options

Related Documents