task-file-builder

Draft a complete task.md brief with structured sections and acceptance criteria.

2|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/pengqianhan/open-paper-skills --skill task-file-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-file-builder
Source: https://github.com/pengqianhan/open-paper-skills/tree/main/.claude/skills/task-file-builder
Command: npx skills add https://github.com/pengqianhan/open-paper-skills --skill task-file-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill helps you rapidly create a complete, well-structured task.md brief for Claude Code by guiding you through Objective, Acceptance Criteria, Relevant Files, Constraints, Background, Known Context, and Questions, following Opus 4.7 best practices. It is useful whenever you want to prepare a task, brief, spec, prompt, plan, or instructions for Claude Code to execute in a fresh session — even if you don't explicitly ask for a "task.md". Trigger phrases include "help me write a task", "draft instructions for Claude Code", "prepare a brief", "plan what to ask Claude to do", "turn this idea into a task.md", "write a spec for Claude", or "front-load context for a new Claude Code session".

Core Features & Use Cases

  • Understand the task by examining the bundled templates at assets/task_template.md and the example task to align with Opus 4.7 guidance.
  • Batch clarifying questions in a single pass to gather Objective, Acceptance Criteria, Relevant Files, Constraints, Background, Known Context, and Questions.
  • Draft the complete task.md using the standard template, with precise file paths and domain terms preserved.
  • Present the draft inline and offer one revision pass before finalizing.
  • Provide execution guidance to run the task in Claude Code either in a fresh session or by pasting the final task.md contents into a new session.

Quick Start

Provide the objective and constraints, and I will draft a complete task.md ready for execution.

Frequently Asked Questions about task-file-builder

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

FAQPage Schema
How do I write a task brief for Claude Code to front-load context in a fresh session?

To write a task brief for Claude Code, draft a structured task.md file containing Objective, Acceptance Criteria, Relevant Files, Constraints, Background, Known Context, and Questions. This front-loads all necessary context into a fresh session for precise execution.

What should be included in acceptance criteria for a Claude Code task.md?

Acceptance criteria in a task.md should be concrete and verifiable conditions that define task completion. The brief guides you through specifying these criteria alongside objectives and constraints, ensuring Claude Code outputs can be validated against strict requirements.

How do I prepare a prompt specification for Claude Code following Opus 4.7 best practices?

Preparing a prompt specification for Claude Code following Opus 4.7 best practices involves batching clarifying questions to gather Objective, Constraints, and Known Context. The resulting task.md aligns with Opus 4.7 guidance for optimal execution.

Can I draft instructions for Claude Code without explicitly asking for a task.md file?

Yes, you can draft instructions for Claude Code without explicitly asking for a task.md file. Trigger phrases like prepare a brief or plan what to ask Claude to do automatically generate a ready-to-apply task.md with structured sections and verifiable acceptance criteria.

What is the best way to turn an idea into a structured spec for Claude Code?

The best way to turn an idea into a structured spec for Claude Code is through a guided drafting process. It examines bundled templates, batches clarifying questions in a single pass, and outputs a task.md preserving precise file paths and domain terms.

Does the task.md template preserve specific file paths and domain terms during drafting?

Yes, the task.md template preserves specific file paths and domain terms during drafting. The brief uses the standard template to ensure precise technical vocabulary and file references remain intact for accurate Claude Code execution.