Tasks Management

Claude Code plugin for project-level task tracking with YAML storage and auto-archive.

Installation

From Local Path (Development)

Claude Code requires plugins to be part of a "marketplace". For local development:

# 1. Validate the plugin structure
claude plugin validate /path/to/tasks-management

# 2. Add as a local marketplace
claude plugin marketplace add /path/to/tasks-management

# 3. Install from the marketplace
claude plugin install tasks-management@alejandro-plugins --scope user

Scope Options

• --scope user - Available in all projects (recommended for personal plugins)
• --scope project - Only available in current project

Verify Installation

claude plugin list
# or use /plugin command in Claude Code

Plugin Structure

Claude Code expects this directory structure:

tasks-management/
├── .claude-plugin/
│   ├── plugin.json       # Plugin metadata (required)
│   └── marketplace.json  # Marketplace manifest (required for local install)
├── commands/             # Slash commands (auto-discovered)
│   ├── task.md
│   └── tasks.md
├── skills/               # Skills (auto-discovered)
│   └── task-management/
│       ├── SKILL.md
│       ├── scripts/
│       └── references/
└── README.md

plugin.json Format

{
  "name": "tasks-management",
  "version": "1.0.0",
  "description": "Plugin description",
  "author": {
    "name": "Your Name"
  }
}

Note: Do NOT include skills or commands fields - Claude Code auto-discovers them.

marketplace.json Format

{
  "name": "your-marketplace-name",
  "description": "Your plugins collection",
  "owner": {
    "name": "Your Name"
  },
  "plugins": [
    {
      "name": "tasks-management",
      "description": "Plugin description",
      "version": "1.0.0",
      "author": { "name": "Your Name" },
      "source": "./",
      "category": "productivity"
    }
  ]
}

Features

• YAML storage at .claude/tasks/tasks.yaml
• Auto-archive on completion
• Markdown view generation
• Filtering by status, tags, priority
• Extensible task schema

Quick Usage

node .claude/skills/task-management/scripts/task-cli.cjs add "Task title" --priority high
node .claude/skills/task-management/scripts/task-cli.cjs list
node .claude/skills/task-management/scripts/task-cli.cjs complete t-001

Plugin Commands

• /task add <title> - Create new task
• /task <id> - View task details
• /tasks - List all tasks

Updating the Plugin

After making changes to your local plugin:

# Update the marketplace cache
claude plugin marketplace update alejandro-plugins

# Update the installed plugin
claude plugin update tasks-management@alejandro-plugins

Uninstalling

# Uninstall the plugin
claude plugin uninstall tasks-management@alejandro-plugins

# Optionally remove the marketplace
claude plugin marketplace remove alejandro-plugins

Troubleshooting

"Plugin not found in marketplace"

The plugin identifier must match the marketplace name. Use plugin@marketplace format:

# Correct
claude plugin install tasks-management@alejandro-plugins

# Wrong - no marketplace specified
claude plugin install tasks-management

Validation Errors

Run validation to check structure:

claude plugin validate /path/to/tasks-management

Common issues:

• Missing .claude-plugin/plugin.json
• Missing .claude-plugin/marketplace.json for local installs
• Path traversal (..) not allowed in paths

Plugin Not Loading

1. Check /doctor for plugin errors
2. Verify plugin is enabled in settings
3. Restart Claude Code after installation

License

MIT