notion-tasks — Claude Code skill: Notion tasks and setup
notion-tasks is a Claude Code skill that finds Oak AI squad tasks and sprints in Notion, filters by status, and checks task owners or progress.
MIT 1 installs ★ 35 updated 2026-10-28
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a claude-codeWhat notion-tasks does
The skill looks up the current sprint, then finds tasks linked to it. You can also filter tasks by statuses such as In progress, Ready, and Ready for review. Notion API tools handle the queries.
Add the database IDs to config.local.md; config.local.md.example shows the expected format. The filter_properties option limits the fields returned, and filtered queries can use a page size from 50 to 100. Without the database IDs, the skill cannot target the relevant Notion data.
It also explains what task statuses mean. For instance, Blocked marks work held up by dependencies, while Ready for review means the code is waiting for review. That distinction helps when checking which work can move forward and which still needs assessment or planning.
What it helps with
- find tasks in the current sprint
- filter tasks by status
- check who owns a task
- interpret task status labels
Example prompts for the agent
- Find tasks in the current sprint and show their statuses.
- List tasks marked
Ready for reviewwith their owners. - Explain which backlog tasks still need planning.
How to install notion-tasks
1Skills CLI (Vercel)
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a claude-code2Manually: put the files in place
~/.claude/skills/notion-tasks/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/notion-tasks/
1Skills CLI (Vercel)
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a codex2Manually: put the files in place
.agents/skills/notion-tasks/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a cursor2Manually: put the files in place
.cursor/skills/notion-tasks/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oaknational/oak-ai-lesson-assistant .claude/skills/notion-tasks2Manually: put the files in place
.github/skills/notion-tasks/SKILL.md1Skills CLI (Vercel)
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a gemini-cli2Platform CLI
gemini skills install https://github.com/oaknational/oak-ai-lesson-assistant --path .claude/skills/notion-tasksManually: put the files in place
.devin/skills/notion-tasks/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about notion-tasks
How do I install notion-tasks in Claude Code?
Run npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a claude-code. The skill file is at ~/.claude/skills/notion-tasks/SKILL.md.
What does notion-tasks do?
It queries Oak AI tasks and sprints in Notion, filters tasks by status, and helps make team priorities and task stages easier to inspect.
What must I configure before using notion-tasks?
Put the Notion database IDs in config.local.md. The expected format is shown in config.local.md.example.
Source text
SKILL.md · MIT
---
name: notion-tasks
description: Query and manage Oak AI squad tasks and sprints in Notion. Use when checking current sprint, finding tasks by status, updating task information, or understanding team priorities and workload.
allowed-tools: mcp__notionApi__API-post-database-query, mcp__notionApi__API-retrieve-a-page, mcp__notionApi__API-get-block-children
---
# Notion Task Management
## Setup
Database IDs are stored in `config.local.md` (not checked into git). See `config.local.md.example` for the required format.
## Finding Current Sprint Tasks
1. **Find current sprint**: Query sprints database with filter:
```json
{ "property": "Sprint status", "status": { "equals": "Current" } }
```
2. **Get sprint ID** from the result (e.g., `13d26cc4-e1b1-8108-9fb3-d74429e520c6`)
3. **Query tasks** with filter:
```json
{ "property": "Sprint", "relation": { "contains": "SPRINT_ID" } }
```
## Efficient Querying with filter_properties
- **Essential fields**: `["title", "pPPj", "FH@y", "RIV<", "pIdo"]`
- These map to: Task, Status, Who, Type, ID
- **Use filter_properties**: Reduces response size significantly
- **Page size**: Can use 50-100 when filtering properties
**Example query:**
```json
{
"database_id": "TASKS_DB_ID",
"filter": {
"property": "Sprint",
"relation": { "contains": "SPRINT_ID" }
},
"filter_properties": ["title", "pPPj", "FH@y", "RIV<", "pIdo"],
"page_size": 50
}
```
## Common Task Filters
- **In progress**: `{"property": "Status", "status": {"equals": "In progress"}}`
- **Ready tasks**: `{"property": "Status", "status": {"equals": "Ready"}}`
- **Ready for review**: `{"property": "Status", "status": {"equals": "Ready for review"}}`
- **Current sprint tasks**: First get current sprint ID, then filter by Sprint relation
## Task Status Meanings
- **Ready**: Available to pick up and start development
- **Backlog**: Not ready for development yet, needs planning/refinement
- **Candidate**: Being evaluated, not ready for development
- **Triage**: Needs assessment before development
- **In progress**: Currently being worked on
- **Ready for review**: Code complete, awaiting review
- **Merged**: Code merged to main branch
- **Done**: Task completed
- **Blocked**: Cannot proceed due to dependencies
© oaknational · MIT · oaknational/oak-ai-lesson-assistant