Claude-skill-registry handler-work-tracker-linear

[DEPRECATED] Linear handler - Use Fractary CLI instead

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/handler-work-tracker-linear" ~/.claude/skills/majiayu000-claude-skill-registry-handler-work-tracker-linear && rm -rf "$T"

manifest: skills/data/handler-work-tracker-linear/SKILL.md

Linear Work Tracker Handler

⚠️ DEPRECATED: This handler is deprecated. Skills now use Fractary CLI (
fractary work <command>
) directly instead of platform-specific handlers.

Migration: See
specs/WORK-00356-implement-faber-cli-work-commands.md
for the CLI migration plan.

<CONTEXT> You are the Linear handler for the work plugin. This handler is **DEPRECATED** as of the CLI migration.

New approach: Skills invoke

fractary work <command> --json

directly instead of routing through platform-specific handlers.

Why deprecated:

CLI provides platform abstraction at a lower level
Reduces context by eliminating handler layer
Simplifies skill implementations
Centralized maintenance in CLI codebase </CONTEXT>

<CRITICAL_RULES>

DEPRECATED - Do not use this handler for new implementations
Skills should use Fractary CLI directly:
```
fractary work <command> --json
```
Existing scripts retained for backward compatibility only
No new features will be added to this handler </CRITICAL_RULES>

Migration Guide

Before (Handler-based)

Skill → Handler → scripts/*.sh → Linear GraphQL API

After (CLI-based)

Skill → Fractary CLI → Linear GraphQL API

Example Migration

Before (deprecated):

# Skill invokes handler script
./scripts/fetch-issue.sh TEAM-123

After (recommended):

# Skill invokes CLI directly
fractary work issue fetch TEAM-123 --json

CLI Command Mapping

Handler Operation	CLI Command	Status
fetch-issue	`fractary work issue fetch <id>`	✅ Available
create-issue	`fractary work issue create`	✅ Available
update-issue	`fractary work issue update <id>`	✅ Available
close-issue	`fractary work issue close <id>`	✅ Available
reopen-issue	`fractary work issue reopen <id>`	❌ Missing
list-issues	`fractary work issue search`	✅ Available
create-comment	`fractary work comment create <id>`	✅ Available
list-comments	`fractary work comment list <id>`	✅ Available
add-label	`fractary work label add <id>`	✅ Available
remove-label	`fractary work label remove <id>`	✅ Available
assign-issue	`fractary work issue assign <id>`	❌ Missing
classify-issue	`fractary work issue classify <id>`	❌ Missing

Backward Compatibility

Existing scripts in

scripts/

are retained for:

Backward compatibility with old skill versions
Reference implementations for CLI development
Testing and validation

Scripts will be removed in a future major version once CLI migration is complete.

Dependencies (for legacy scripts)

Required Tools

```
curl
```
- HTTP requests
```
jq
```
- JSON processor

Environment Variables

```
LINEAR_API_KEY
```
- Linear API key

Script Locations (Legacy)

handler-work-tracker-linear/
├── SKILL.md (this file)
├── scripts/                    # DEPRECATED - for backward compatibility only
│   ├── fetch-issue.sh
│   ├── classify-issue.sh
│   ├── create-comment.sh
│   ├── add-label.sh
│   ├── remove-label.sh
│   ├── close-issue.sh
│   ├── reopen-issue.sh
│   ├── update-state.sh
│   ├── list-issues.sh
│   └── ...
└── docs/
    └── linear-api.md

Linear-Specific Notes (Reference)

Authentication

Linear uses Bearer token authentication with API key.

Issue Identifiers

Format:

TEAM-NUMBER

(e.g., ENG-123) or UUIDs internally.

GraphQL API

Linear uses GraphQL for all operations.

UUID Lookups

Labels, states, and users are referenced by UUID. Scripts must lookup UUIDs by name.