Skip to content
handler-work-tracker-github logo

GitHub Work Tracker Handler

handler-work-tracker-github

[DEPRECATED] GitHub Issues handler - Use Fractary CLI instead

SKILL.md

Full skill instructions

GitHub 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 GitHub Issues 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:

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

<CRITICAL_RULES>

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

Migration Guide

Before (Handler-based)

Skill → Handler → scripts/​*.sh → GitHub API

After (CLI-based)

Skill → Fractary CLI → GitHub API

Example Migration

Before (deprecated):

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

After (recommended):

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

CLI Command Mapping

Handler OperationCLI CommandStatus
fetch-issuefractary work issue fetch <n>✅ Available
create-issuefractary work issue create✅ Available
update-issuefractary work issue update <n>✅ Available
close-issuefractary work issue close <n>✅ Available
reopen-issuefractary work issue reopen <n>❌ Missing
list-issuesfractary work issue search✅ Available
create-commentfractary work comment create <n>✅ Available
list-commentsfractary work comment list <n>✅ Available
add-labelfractary work label add <n>✅ Available
remove-labelfractary work label remove <n>✅ Available
assign-issuefractary work issue assign <n>❌ Missing
classify-issuefractary work issue classify <n>❌ 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

Environment Variables

  • GITHUB_TOKEN - GitHub personal access token

Script Locations (Legacy)

handler-work-tracker-github/
├── 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/
    └── github-api.md

See Also

  • specs/​WORK-00356-implement-faber-cli-work-commands.md - CLI migration spec
  • specs/​WORK-00356-1-missing-cli-work-commands.md - Missing CLI commands
  • plugins/​work/​skills/​cli-helper/​SKILL.md - CLI invocation patterns