skills.rest
JoziGila
JoziGilaCOMMUNITY
Explore all skills by this author →
GitHub

speculate

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

2|Updated Nov 1, 2025
One-click install
npx skills add https://github.com/JoziGila/speculate --skill speculate
Or copy as Structured Prompt for Agent▼
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.

Related Skills

kevinlinkevinlin
14

feature-spec

Generate a structured PRD with problem statements, goals, user stories, and acceptance criteria.

Community
Advanced
pwnk77pwnk77
59

Progress Tracker

Track task completion and generate automated project status reports.

Community
Intermediate
hiroshi75hiroshi75
1

langgraph-architect

Design and implement LangGraph agent architectures with graph patterns and subgraphs.

Community
Advanced
brittbritt
1

timeline-planning

Generate Mermaid Gantt charts from GitHub issues and estimates.

Community
Intermediate