Claude Code Plugins

Community-maintained marketplace

Feedback

notion-tasks

@oaknational/oak-ai-lesson-assistant
28
0

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.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

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:

    { "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:

    { "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:

{
  "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