crafter-scaffold-task

Create a structured Crafter task file from templates/TASK.md with collision checks.

2|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/richardriman/crafter --skill crafter-scaffold-task
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crafter-scaffold-task
Source: https://github.com/richardriman/crafter/tree/main/skills/crafter-scaffold-task
Command: npx skills add https://github.com/richardriman/crafter --skill crafter-scaffold-task

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Crafter scaffold task skill provides a reliable way to generate new task files from a canonical template, eliminating the tedium and inconsistency of hand-assembling task structures.

Core Features & Use Cases

  • Composable, agent-only scaffold that materializes a new task file from templates/TASK.md
  • Ensures every task starts with the same structure: Metadata, verbatim Request, Plan placeholder, Decisions, and Outcome
  • Performs collision checks, derives the target path, and writes the file under the resolved context directory (prefer .crafter/, fallback to .planning/)
  • Useful during the task-lifecycle setup when the orchestrator needs to create a new task file for a work item

Quick Start

Create a new task file in the resolved context directory from the canonical TASK template.

Frequently Asked Questions about crafter-scaffold-task

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

FAQPage Schema
How do I automate task file creation from a markdown template?

Automating task file creation from a markdown template involves reading a canonical TASK.md file, deriving a YYYYMMDD-slug filename, and writing the standardized structure to a tasks directory. This scaffold skill enforces collision checks to prevent overwriting existing files during the task-lifecycle setup.

How does a task scaffold ensure consistent task lifecycle structure?

A task scaffold ensures consistent lifecycle structure by applying a canonical template that standardizes content into Metadata, verbatim Request, Plan placeholder, Decisions, and Outcome sections. It materializes new task files with uniform formatting to eliminate the inconsistency of hand-assembling task structures.

What is the best way to prevent file collisions when generating task files?

Preventing file collisions when generating task files requires validating the non-existence of the target path before writing. This scaffold derives the filename as YYYYMMDD-slug and performs collision checks against the resolved context directory to ensure no existing task files are overwritten.

Where should generated task files be stored in a project workflow?

Generated task files should be stored under the resolved context directory, preferring the .crafter/ folder or falling back to .planning/. The scaffold writes the newly created task file to the tasks/ subdirectory within this resolved context to maintain organized workflow automation.

Does the task scaffold require manual editing of the template structure?

The task scaffold does not require manual editing of the template structure because it reads templates/TASK.md to source the structure automatically. It fills the metadata and verbatim request while preserving the Plan placeholder, ensuring standardized content generation without manual assembly.

Can I use this scaffold to generate tasks for any project context?

You can use this scaffold to generate tasks for any project context that supports the expected directory structure. It resolves the context directory dynamically and applies the canonical template to produce standardized task files, making it composable for agent-only task-lifecycle setups across different projects.