Task Complexity Estimator

**Version:** 1.0.0

14 stars

Best use case

Task Complexity Estimator is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

**Version:** 1.0.0

Teams using Task Complexity Estimator should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/complexity/SKILL.md --create-dirs "https://raw.githubusercontent.com/masharratt/claude-flow-novice/main/.claude/skills/cfn-task-intelligence/lib/complexity/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/complexity/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How Task Complexity Estimator Compares

Feature / Agent	Task Complexity Estimator	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

**Version:** 1.0.0

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Task Complexity Estimator

**Version:** 1.0.0
**Purpose:** Estimate task complexity and predict iteration requirements for CFN v3

## Overview

Analyzes task description to estimate:
- Complexity level (low, medium, high)
- Estimated iterations (2-7 range)
- Confidence in estimate

## Complexity Factors

### Factor 1: Step Count
- Count distinct action verbs
- Count deliverable files mentioned
- Count integration points

### Factor 2: Security/Compliance
- Security keywords → +1 complexity
- Compliance requirements → +1 complexity
- Authentication/authorization → +1 complexity

### Factor 3: Scope
- Single file → low
- Multiple files (2-5) → medium
- System-wide (>5 files) → high

### Factor 4: Dependencies
- External APIs → +1 complexity
- Database changes → +1 complexity
- Multiple services → +1 complexity

### Factor 5: Technology Stack
- Familiar tech → -1 complexity
- New/unfamiliar tech → +1 complexity
- Cutting-edge/experimental → +2 complexity

## Estimation Formula

```
Base Iterations = 2

+ Step Count / 3
+ Security factor (0-2)
+ Scope factor (0-3)
+ Dependencies factor (0-3)
+ Tech stack factor (-1 to +2)

Capped at: 7 iterations (high complexity max)
```

## Complexity Mapping

| Total Score | Complexity | Estimated Iterations |
|-------------|------------|---------------------|
| 0-2 | Low | 2 |
| 3-4 | Medium | 3-4 |
| 5+ | High | 5-7 |

## Usage

```bash
ESTIMATE=$(./.claude/skills/complexity-estimator/estimate-complexity.sh \
  --task-type "software-development" \
  --description "Implement JWT authentication with refresh tokens and RBAC")

echo "$ESTIMATE" | jq '.complexity'           # "high"
echo "$ESTIMATE" | jq '.estimated_iterations' # 5
echo "$ESTIMATE" | jq '.confidence'           # 0.75
```

## Output Format

```json
{
  "complexity": "low|medium|high",
  "estimated_iterations": 2-7,
  "confidence": 0.0-1.0,
  "factors": {
    "step_count": 2,
    "security": 1,
    "scope": 2,
    "dependencies": 1,
    "tech_stack": 0
  },
  "reasoning": "High complexity due to security requirements (JWT, RBAC), multiple integration points, and estimated 6+ file changes."
}
```

## Integration

Used by:
- `.claude/agents/cfn-v3-coordinator.md` - Set max_iterations, estimated_iterations
- Playbook system - Store complexity patterns

Related Skills

We are still matching the closest adjacent skills for this page. In the meantime, continue through the full directory.