Agent skill
generating-subtasks
Converts approved design documents into agent-executable XML subtasks. Use after a design doc is approved and ready for implementation.
Install this agent skill to your Project
npx add-skill https://github.com/SteveBronder/skillrena/tree/main/skillrena/generating-subtasks
SKILL.md
<subtask_schema>
Agent-executable subtasks go in design-docs/agents/<design-doc-name>.xml.
This file is generated ONLY after the user approves the human-readable subtasks in the main design doc. IMPORTANT: If you have the user do not have subtask written in the markdown design doc, do NOT generate this file. You must generate the subtasks in the markdown file first, then wait for user instructions before continuing with building the XML file. The XML file wraps all tasks in a root element and follows this schema:
<?xml version="1.0" encoding="UTF-8"?>
<design-doc-tasks>
<metadata>
<design-doc>YYYYMMDD-slug.md</design-doc>
<created>YYYY-MM-DD</created>
<approved-by>user</approved-by>
</metadata>
<task id="T1-slug" owner="unassigned" status="planned">
<summary>One sentence objective.</summary>
<scope>
<in>Concrete inclusions.</in>
<out>Concrete exclusions.</out>
</scope>
<reuse_check>
<search_terms>
<term>...</term>
</search_terms>
<existing_utilities>
<candidate>path::symbol</candidate>
</existing_utilities>
<decision>reuse|extend|new</decision>
<justification>Required if decision != reuse.</justification>
</reuse_check>
<interfaces>
<exports>
<function name="...">
<signature>...</signature>
<types>
<param name="...">...</param>
<returns>...</returns>
</types>
<invariants>
<invariant>...</invariant>
</invariants>
<optionals>
<allowed>false|true</allowed>
<justification>Required if Optional/None exists.</justification>
</optionals>
</function>
</exports>
</interfaces>
<implementation_plan>
<step>...</step>
</implementation_plan>
<test_data>
<required>true|false</required>
<source>http|websocket|file|db|synthetic</source>
<gap_analysis>What is missing vs required.</gap_analysis>
<plan>Record/replay, generator, or harness.</plan>
<fixture_paths>
<path>tests/fixtures/...</path>
</fixture_paths>
<validation>
<check>schema validation</check>
<check>golden aggregates</check>
</validation>
</test_data>
<tests>
<add>
<test_file>tests/.../test_*.py</test_file>
<assertion>What this test proves.</assertion>
</add>
<update>
<test_file>...</test_file>
<change>...</change>
</update>
</tests>
<commands>
<cmd>...</cmd>
</commands>
<acceptance>
<criterion>Binary "passes when ...".</criterion>
</acceptance>
<!-- IMPORTANT!!!: YOU MUST CHANGE task_completed_status TO TRUE WHEN THE TASK IS COMPLETE -->
<task_completed_status>
false
</task_completed_status>
<safety>
<destructive_actions>false</destructive_actions>
<notes>Any risk or confirmation requirements.</notes>
</safety>
</task>
<!-- Additional tasks follow the same structure -->
<task id="T2-slug" owner="unassigned" status="planned">
...
</task>
</design-doc-tasks>
</subtask_schema>
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
SteveBronder/skillrena
recording-diary
Records session learnings and decisions before context compaction. Use before ending a long session or when the user asks to save session notes.
SteveBronder/skillrena
activating-memories
Loads project-specific memories at session start and triggers onboarding for new projects. Use when starting a new coding session or when the user says "activate" or asks about project context.
SteveBronder/skillrena
writing-memories
Writes or updates memory files with proper YAML frontmatter in the agent's memories directory. Use when saving new project learnings or updating existing memory files.
SteveBronder/skillrena
generate-modes
Generates three project-specific behavioral mode skills (planner, debugger, qa-tester) from project memories and bundled templates, and makes them selectable via switching-modes. Use when creating project-local agent modes for a repository.
SteveBronder/skillrena
bootstrapping-design-docs
Creates design document infrastructure including templates, workflows, and a specific design doc skill. Use when setting up design docs for a new project or when the user mentions "bootstrapping-design-docs".
mattpocock/skills
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
Didn't find tool you were looking for?