Verified:GitHub

speculate

Generate executable task graphs with atomic tasks and Mermaid diagrams from software goals.

2|Updated Nov 1, 2025

Ready to run

npx skills add https://github.com/JoziGila/speculate --skill speculate

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: speculate
Source: https://github.com/JoziGila/speculate/tree/main/.claude/skills/speculate
Command: npx skills add https://github.com/JoziGila/speculate --skill speculate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps teams translate complex software goals into executable task graphs, reducing planning time and rework by decomposing into atomic tasks with clear dependencies.

Core Features & Use Cases

Atomic Task Decomposition: Break goals into 1-4 hour tasks with clear done states.
Dependency Tracking: Visualize blocks, relates_to, and part_of relationships.
Mermaid Diagrams & Progress: Generate color-coded diagrams to reflect ready, blocked, in-progress, and done tasks.
Claude Integration: Works with Claude to plan, track, and optimize work graphs for software features.

Quick Start

Start a new planning session by initializing a graph and then viewing the available tasks.

Frequently Asked Questions about speculate

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

FAQPage Schema

How do I break down a complex software feature into executable tasks?▼

Task decomposition translates software goals into atomic tasks by breaking features into 1-4 hour units with clear done states, explicit dependencies (blocks, relates_to, part_of), and parallelization opportunities. This Skill generates task graphs as Mermaid diagrams and executable payloads to guide team execution.

What's the best way to visualize task dependencies and project flow?▼

Generate color-coded Mermaid diagrams that reflect task status: ready, blocked, in-progress, and done. The diagram format makes dependencies visible and helps teams identify which tasks can run in parallel and which are blocked by predecessors.

How do I plan authentication, payments, or integration features with clear task order?▼

Start a planning session by initializing a task graph, then decompose your feature goal into atomic tasks with enforced kebab-case naming, 1-4 hour estimates, and explicit relationship tracking. The Skill outputs both diagrams and structured payloads ready for execution.

Can I use task graphs to track progress and reduce planning rework?▼

Yes. Task graphs enforce atomic boundaries and clear relationships, reducing ambiguity and rework. Mermaid visualizations update as tasks move through ready, blocked, in-progress, and done states, giving teams real-time visibility into feature progress.

Does this work with Claude for collaborative planning and task optimization?▼

The Skill integrates with Claude to plan, track, and optimize work graphs. Claude can help decompose goals, refine estimates, identify parallelization opportunities, and generate updated diagrams as the plan evolves.