reclaim-skills

Reclaim Skills for Claude Code

Manage Reclaim.ai calendar tasks directly from Claude Code with a safety-first approach.

Table of Contents

• Overview
• Features
• Installation
• Usage
• Confirmation Workflow
• Skill Documentation
• Common Workflows
• Task Properties Reference
• License
• Support

Overview

This skill provides comprehensive CRUD operations for Reclaim.ai tasks with a safety-first approach. All write operations (create, update, complete, delete) require explicit user confirmation before execution.

Features

• Create tasks with flexible options (priority, duration, dates, time schemes, splitting)
• Update tasks to change any task property
• List and filter tasks (active, completed, overdue)
• Complete tasks (marks as ARCHIVED)
• Delete tasks permanently
• Query time schemes to see available scheduling windows
• Confirmation workflow for all write operations to prevent accidental changes

Installation

Install from the Claude Code plugin marketplace:

/plugin marketplace add benjaminjackson/reclaim-skills
/plugin install reclaim-tasks@reclaim-skills

Or browse and install via the /plugin menu.

Prerequisites:

1. Reclaim.ai account - Sign up at reclaim.ai
2. Reclaim CLI:

   gem install reclaim
   

3. Verify CLI installation:

   reclaim --help
   

Usage

The skill activates automatically when you mention tasks, Reclaim, or scheduling. You don't need to explicitly invoke it.

Quick Examples

List tasks:

Show me my active Reclaim tasks

Create a task:

Create a Reclaim task called "Write proposal" due Friday, P1 priority, 3 hours

Update a task:

Update task abc123 to P2 priority and change due date to next Monday

Complete a task:

Mark task abc123 as complete

Confirmation Workflow

For all write operations (create, update, complete, delete), Claude will:

1. Parse your request
2. Show you the exact command that will be executed
3. Ask for confirmation using a dialog
4. Execute only after you approve

Read operations (list, get, list-schemes) execute immediately without confirmation.

Skill Documentation

The skill includes three documentation files:

• SKILL.md - Quick reference and overview
• EXAMPLES.md - Comprehensive examples for all workflows
• REFERENCE.md - Complete option and command reference

Claude will progressively load these as needed to answer your questions.

Common Workflows

Morning Planning

Show me my overdue tasks
List my active tasks for today
Update task xyz to P1 priority

Quick Task Capture

Create a task "Review PR" with 30 minutes duration
Add a task "Team standup" tomorrow at 9am, 1 hour

Task Management

Show details for task abc123
Change the due date of task abc123 to next Friday
Mark task abc123 as complete

Advanced Scheduling

Create a 6-hour task "Documentation sprint" that can be split into 1.5 hour chunks, P2 priority, work hours only

Task Properties Reference

Priority Levels

• P1 - Highest priority (urgent and important)
• P2 - High priority
• P3 - Medium priority (default)
• P4 - Low priority

Duration Format

Specified in hours (decimal):

• 0.25 = 15 minutes
• 0.5 = 30 minutes
• 1 = 1 hour
• 1.5 = 90 minutes
• 2 = 2 hours
• 4 = 4 hours

Date Formats

• Date: YYYY-MM-DD (e.g., 2025-11-15)
• DateTime: YYYY-MM-DDTHH:MM:SS (e.g., 2025-11-15T14:30:00)
• Clear date: Use none, clear, or null

Time Schemes

Use aliases for common schemes:

• work, working hours, business hours → Work time
• personal, off hours, private → Personal time
• Or use specific scheme IDs from reclaim list-schemes

License

MIT License - see LICENSE file for details.

Support

• Issues: GitHub Issues
• Reclaim.ai: Reclaim Support
• Claude Code: Claude Code Documentation