complexity-gate

Estimate issue complexity and output structured JSON with split suggestions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/pcortes/swarm-attack --skill complexity-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complexity-gate
Source: https://github.com/pcortes/swarm-attack/tree/main/swarm_attack/skills/complexity-gate
Command: npx skills add https://github.com/pcortes/swarm-attack --skill complexity-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Estimate issue complexity before implementation to prevent timeouts and guide splitting decisions.

Core Features & Use Cases

  • Turn estimation: approximate LLM turns required for implementation.
  • Split recommendations: needs_split flag and concrete split suggestions.

Quick Start

Provide issue title, body, and acceptance criteria; returns an estimation including estimated_turns, complexity_score, needs_split, and suggestions.

Frequently Asked Questions about complexity-gate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I estimate complexity and LLM turns before implementing an issue?

Complexity estimation determines the number of LLM turns required for implementation by analyzing issue title, body, and acceptance criteria. The Skill outputs a complexity score, estimated turns, and a needs_split flag to guide whether work should be split into smaller tasks before development begins.

When should I split an issue into smaller tasks?

Split recommendations are generated when estimated LLM turns exceed complexity thresholds that risk timeouts. The Skill provides concrete split suggestions based on acceptance criteria, helping you break work into manageable chunks that fit within LLM turn budgets.

What information do I need to provide for accurate complexity estimation?

Provide the issue title, full description or body, and acceptance criteria. The Skill analyzes these inputs against complexity guidelines to calculate estimated turns, confidence levels, and detailed reasoning for its recommendations.

Can complexity estimation prevent LLM implementation timeouts?

Yes. By estimating turns upfront and flagging issues that need splitting, you avoid starting work that exceeds LLM capacity limits. This prevents mid-implementation failures and guides better planning decisions for LLM-based development workflows.

What does the complexity score tell me about implementation difficulty?

The complexity score quantifies implementation difficulty relative to LLM turn capacity. Combined with the estimated_turns value and confidence level, it indicates whether an issue is ready to implement or requires splitting into lower-complexity subtasks.