# tasks-build

Build a task from a Notion page URL. Fetches task details, marks it in progress, implements the work, and updates status in Notion.

Skill by Notion. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx skills add makenotion/cursor-notion-plugin --skill tasks-build
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add makenotion/cursor-notion-plugin --skill tasks-build -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Warn
- Runlayer: Pass
- ZeroLeaks: Pass

Installs: 35. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/makenotion/cursor-notion-plugin/tasks-build)

## Source

[Open the source](https://github.com/makenotion/cursor-notion-plugin/tree/HEAD/skills/tasks-build). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
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
````

- Previous: [create-database-row](https://syn4pse.dev/terminal/notion-create-database-row.md)
- Next: [tasks-explain-diff](https://syn4pse.dev/terminal/notion-tasks-explain-diff.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
