skills-planner

Skills Planner

Plan and compose skills to fulfill user requirements efficiently.

Workflow

1. Analyze Requirements - Understand user goals and constraints
2. Evaluate Existing Skills - Match requirements to available skills
3. Identify Gaps - Determine what capabilities are missing
4. Design New Skills - Specify requirements for missing skills (if any)
5. Compose Agent - Design system prompt for the agent using all skills
6. Present Plan - Output structured plan for user confirmation

Input Requirements

Before planning, gather:

• User Requirements: What the user wants to accomplish
• Existing Skills List: Available skills with their descriptions

Planning Process

Step 1: Analyze Requirements

Break down user requirements into discrete capabilities:

User Request: "Build an agent that can analyze financial reports"

Required Capabilities:
1. PDF reading/parsing
2. Data extraction (tables, numbers)
3. Financial metrics calculation
4. Report generation
5. Visualization (charts)

Step 2: Evaluate Existing Skills

For each capability, check if an existing skill covers it:

Capability: PDF reading/parsing
Existing Skill Match: pdf (extracts text/tables from PDFs) ✓

Capability: Financial metrics calculation
Existing Skill Match: None found ✗

Selection Criteria:

• Prefer skills that directly match the capability
• Consider skill scope (narrow and focused > broad and generic)
• Check for overlapping functionality to avoid redundancy

Step 3: Identify Gaps

List capabilities not covered by existing skills. These become candidates for new skills.

Gap Analysis Questions:

• Is this capability truly necessary, or can existing skills be combined?
• Can the base model handle this without a skill?
• Is this capability reusable across other tasks?

Step 4: Design New Skills (if needed)

For each gap, specify:

skill_name: financial-analyzer
skill_requirements: |
  Purpose: Calculate and interpret financial metrics from extracted data

  Core Capabilities:
  - Calculate common ratios (P/E, ROE, debt-to-equity, etc.)
  - Identify trends across time periods
  - Flag anomalies or concerns
  - Generate insights in plain language

  Input: Structured financial data (revenue, expenses, assets, etc.)
  Output: Analysis report with metrics, trends, and recommendations

  Workflow:
  1. Validate input data completeness
  2. Calculate standard financial ratios
  3. Compare to industry benchmarks (if provided)
  4. Identify significant changes or outliers
  5. Generate narrative summary