| name | tasks-build |
| description | Build a task from a Notion page URL. Fetches task details, marks it in progress, implements the work, and updates status in Notion. |
Build 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-diff skill 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
