Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add oaknational/oak-ai-lesson-assistant --skill notion-tasks -a claude-code
Open on GitHub

What 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 review with 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-code

2Manually: put the files in place

~/.claude/skills/notion-tasks/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/notion-tasks/

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

Similar skills

All skills for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open