From ai_dev
Assesses whether a single task file is ready for implementation by checking structure, scope, focus, complexity, contradictions, and ambiguity against a readiness checklist.
How this skill is triggered — by the user, by Claude, or both
Slash command
/ai_dev:task_checkThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
<task_check_skill>
<task_check_skill>
task_check assesses whether a single task file is ready to hand to `task_implement`. It reads one task and produces a direct readiness verdict against a checklist — structure, scope sizing, focus, complexity, freedom from contradiction and ambiguity — surfacing every issue that would lead a one-shot implementer to a wrong or divergent result. It is the pre-implementation gate the base skill's single-shot-ready body design implies. It changes only the lifecycle stamp: `ready` on a clean verdict, `checked` when blocking issues remain, plus `updated`; it moves no file and changes no body content or other frontmatter.<when_to_activate> Activate when the user wants a single task's readiness judged before building:
<task> ready?" / "check this task before I build it" / "assess this task's readiness."Route elsewhere when the user wants to write a task (task_create or the base task skill), automatically repair a task until this gate reports ready (task_auto_check), choose what to work on next (task_select), do the implementation work (task_implement), verify a believed-done task against the codebase (task_audit), close a task (task_finish), or health-check the whole tree (task_fix). The crisp line: task_check judges one task's readiness before building; task_auto_check is the opt-in loop that edits the task and reuses this gate; task_select ranks eligible backlog candidates; task_audit verifies one task's claimed completion after building.
</when_to_activate>
<path_resolution>
The base task skill's discover_tasks.sh ships in scripts/ next to that skill's SKILL.md, not next to this one. After reading the base SKILL.md (per <authority>), resolve the script's absolute path by combining the directory you loaded it from with scripts/<script-name> and invoke that absolute path — never a bare scripts/..., which resolves against the current working directory (the target project) rather than the skill. If the first invocation reports a missing file, re-resolve the absolute path once before treating the script as failed.
</path_resolution>
Assess against the base task skill's <readiness_checklist>, in its order: the charter and structural checks, then the premise, approach-fitness, and Interaction scan checks against the codebase, then the content lens item by item. The checklist lives once in the base skill as the family's single source; apply it from there rather than from a copy here. Every verified checklist finding is a readiness issue and belongs in ## Issues; do not demote a checklist finding to style notes because the implementation could still proceed around it.
Ground every issue before reporting it: an issue enters the report only after you have confirmed it against the repository — read the file it implicates, run the command the acceptance names, check the policy the task cites. An unverifiable suspicion is voiced as a question in the general assessment, never as a numbered issue.
When the Ambiguity / under-specification lens surfaces an open decision, apply the base skill's Decide or label reconciliation rule against its evidence base: when that evidence settles the decision, report the reconciled resolution as the issue's minimum fix; when it does not, surface the decision in the issue with its options and at least one suggested path for the user. Either way task_check stays read-only — it recommends and surfaces, leaving writing the reconciled decision to the editing siblings and the user's apply-findings edit, so the status/updated stamp remains its only mutation.
When the premise check returns its invalidated outcome, state that plainly in the general assessment and surface the base rule's disposition options — close as deferred through task_finish, re-scope the intent, or refute the finding with evidence — as the user's decision to make; the status stamp stays this skill's only mutation either way.
When the base checklist's Interaction scan lens confirms a contradiction or an unattended interaction, report it as a readiness issue carrying its code evidence — the written juxtaposition of the interacting code against the task's change — and apply the base Decide or label rule: recommend the reconciled fix as the issue's resolution when the found code settles it, or surface the interaction with its options and at least one suggested path when it does not. task_check stays read-only either way — it recommends and surfaces and writes no task body content, so the status/updated stamp remains its only mutation.
After assessing, stamp the outcome only: status: ready for a clean implementation-ready verdict, otherwise status: checked, honoring the base skill's <backward_move_guard>, and bump updated. Preserve the task body, all other frontmatter fields, and the file path.
<output_contract> Structure the report in exactly this shape:
# General assessment paragraph: one short paragraph stating whether the task is ready to build and why.## Issues section carrying verified implementation-divergence issues exclusively. When clean, output exactly No issues found. Otherwise list every verified issue as a single ordered list, ranked by how likely each is to cause a wrong or divergent one-shot implementation — most problematic first. Each entry: **[short title]** — where it sits, what is wrong, the implementation impact, and the minimum fix. Locate each issue by label or unambiguous description — the section heading, the pseudo-XML tag, a quoted phrase — per the base skill's soft-pointer rule.Include every verified issue regardless of size. Make only the status/updated stamp and move no file — acting on the findings is task_create/editing, and building is task_implement.
</output_contract>
task_create — write one task filetask_check — readiness gate before building (read-only) (this skill)task_auto_check — autonomously repair one task until task_check reports readytask_explain — explain one task at a high level (read-only)task_select — choose and rank the next eligible task/action (read-only)task_implement — do the worktask_audit — verify a believed-done task against the codebase (read-only)task_finish — close out: set status, bump updated, archivetask_fix — audit and repair the whole tasks treeThese ship together as a family; any sibling may be absent if a deployment excluded it. The default manual chain is create → check → implement → audit → finish, with task_auto_check as an opt-in readiness repair loop, task_select a read-only chooser for what to work on next, and task_fix maintaining the tree.
</task_check_skill>
npx claudepluginhub theafh/ai-modules --plugin ai_devOrchestrates an autonomous readiness loop for a task: runs drift check, gates on task_check, proposes and verifies body repairs, then applies mechanical lint fixes. Stops when ready or no repair remains.
Orchestrates task lists with documentation-first execution, sequential progress tracking, quality checklists, and user confirmations. Use for multi-step implementations and feature development.
Reviews task plans with SRE-level scrutiny to catch edge cases, verify granularity, and strengthen success criteria before implementation. Use after writing-plans and before executing-plans.