About tasks-build
A skill for implementing tasks tracked in Notion, based on the task page and its acceptance criteria. It keeps progress, blockers, and completion updates on the Notion task.
Key features
- 01Fetch task details and references
- 02Update status and agent progress
- 03Implement work from task specifications
- 04Record blockers and questions in Notion
- 05Post a completion summary
Use cases
- 01Implement a code change specified in a Notion task
- 02Keep stakeholders informed through task updates
- 03Request clarification when requirements are unclear
MCP support
Uses Notion MCP tools to read task pages and references, update status and agent fields, and add comments.
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ makenotion/ cursor-notion-plugin --skill tasks-buildAfter installing, type/tasks-buildin Claude Code to confirm it loaded.
Details
From the project READMEBuild Task from Notion
Build a task that is tracked in Notion. The user may be watching the Notion board, so all feedback should be sent through Notion.
Input
The user provides a Notion task URL.
Workflow
1. Fetch the task details
Use the Notion MCP tools to:
- Get the page content including title, description, and any relevant properties
- Look for acceptance criteria, requirements, or specifications
- Read any linked pages or references if needed
2. Mark in progress
- Change the status of the task to "In progress"
- Update the "Agent status" field (if present) to contain a short description: an emoji followed by a word like "Starting..." or "Working..."
3. Build it
- Work on the task per the specification. If this is a codebase, implement the code changes.
- At each step, update the "Agent status" field to explain what's currently happening, so the user can see progress. Keep it brief: a relevant emoji followed by a few words. Examples: "Searching relevant files...", "Updating color scheme...", "Running tests..."
- If you need user input to clarify the spec or answer questions, add a comment to the task prefixed with "Message from AI:" and set any "Agent blocked" field to true.
4. Update the task status
Once complete:
- Update the task status in Notion to "Done"
- If you made a code change, consider using the
tasks-explain-diffskill to generate documentation - Add a final comment summarizing the results
Notes
- If the URL is invalid or inaccessible, ask the user to verify the URL and their Notion connection
- If requirements are unclear, ask clarifying questions before implementing
Comments
Markdown supported