start-task

Assesses task complexity and routes work through simple or complex development workflows.

1|Updated Jun 23, 2026
One-click install
npx skills add https://github.com/seal-harness/seal-harness --skill start-task-seal-harness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-task
Source: https://github.com/seal-harness/seal-harness/tree/main/.agents/skills/start-task
Command: npx skills add https://github.com/seal-harness/seal-harness --skill start-task-seal-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting development work without a clear process leads to missed context, skipped reviews, and inconsistent quality. This Skill provides a structured entry point that recovers prior session state, primes relevant knowledge, assesses task complexity, and routes work into the appropriate workflow before any code is written. ## Core Features & Use Cases - Pre-Task Checklist: Detects interrupted plans in docs/plans/active-plan.md, primes knowledge base rules and gotchas, and checks for open PR comments before starting. - Complexity Assessment: Classifies work as Simple (bug fixes, copy changes) or Complex (new features, API endpoints, multi-file refactors) and confirms the assessment with the user. - Gated Complex Workflow: For complex tasks, enforces GitHub Issue creation, design review gates, plan review gates, orchestrated execution with adversarial review, and self-reflection before PR creation. - Use Case: A developer asks to add a new API endpoint. The Skill primes project knowledge, classifies it as complex, ensures a GitHub Issue with Definition of Done items exists, and routes the work through plan review and orchestrated execution. ## Quick Start Ask the AI to start a new task by describing the work, for example: start a task to add pagination to the users API endpoint.

Frequently Asked Questions about start-task

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

FAQPage Schema
How do I start a new development task with an AI coding assistant?

Invoke the start-task workflow with a task description. It checks for interrupted prior plans, primes project knowledge, assesses complexity with you, and then routes the work into either a streamlined simple flow or a full complex-task checklist.

How does the skill decide between simple and complex task workflows?

It analyzes likely file count, database changes, testing needs, and integration points, then proposes Simple or Complex and asks you to confirm. Simple tasks follow a short checklist; complex tasks get an epic, plan review gate, and orchestrated execution.

What happens if a previous session was interrupted mid-task?

The pre-task checklist looks for docs/plans/active-plan.md with an in-progress status. If found, it asks whether to resume by reloading the plan and execution state, or to abandon the old plan and start fresh.

Does a complex task require a GitHub Issue before implementation?

Yes. Complex tasks always need a GitHub Issue containing clear scope, verifiable Definition of Done items, file scope, and human checkpoints. Simple tasks like bug fixes or copy changes can proceed without one.

What happens when a simple task becomes complex during implementation?

The workflow stops, reassesses complexity, creates an epic task document, switches to the full checklist, and informs you of the change. It may also suggest splitting the work into multiple PRs.