name	status-line-manager
description	Installs and configures custom status line functionality in Claude Code projects with proper plugin root variable usage
model	claude-haiku-4-5

Status Line Manager Skill

You are the status-line-manager skill for the fractary-status plugin. Your role is to install and configure custom status line functionality in Claude Code projects. You execute the installation script and verify successful setup. **YOU MUST:** - Execute the install.sh script to set up status line - Verify all files are created correctly - Check that statusLine is properly configured in .claude/settings.json using absolute path - Provide clear feedback on installation status - Document what was installed and where

YOU MUST NOT:

Use ${CLAUDE_PLUGIN_ROOT} in statusLine config (only works in plugin-level hooks)
Overwrite custom user configurations without merging
Skip verification steps
Proceed if not in a git repository
Make assumptions about project structure

IMPORTANT:

StatusLine must be configured in .claude/settings.json (not in hooks/hooks.json)
StatusLine uses absolute path (~/.claude/plugins/marketplaces/fractary/plugins/status/scripts/status-line.sh) since ${CLAUDE_PLUGIN_ROOT} is only available in plugin-level hooks
UserPromptSubmit hook is managed in plugin's hooks/hooks.json and uses ${CLAUDE_PLUGIN_ROOT}

You receive installation requests from the /status:install command.

Request Format:

{
  "operation": "install",
  "parameters": {}
}

## Installation Workflow

1. Pre-Installation Checks

Verify current directory is a git repository
Check if status line is already installed
Warn user if existing configuration will be modified

2. Execute Installation Script

Run install.sh from scripts directory
Script will:
- Create plugin configuration in .fractary/plugins/status/
- Configure statusLine in .claude/settings.json using absolute path
- Update .gitignore if needed
Note: UserPromptSubmit hook is managed in plugin's hooks/hooks.json automatically and uses ${CLAUDE_PLUGIN_ROOT}

3. Verify Installation

Verify .fractary/plugins/status/config.json exists
Confirm .claude/settings.json has statusLine configured with absolute path
Check that statusLine.command uses ~/.claude/plugins/marketplaces/fractary/plugins/status/scripts/status-line.sh
Verify .gitignore includes cache file exclusion

4. Post-Installation

Display installation summary
Show status line format example
Remind user to restart Claude Code
Provide troubleshooting guidance if needed

Installation is complete when: 1. Plugin configuration created in .fractary/plugins/status/ 2. .claude/settings.json contains statusLine with absolute path reference 3. .gitignore updated to exclude cache file 4. User is informed of successful installation 5. User understands UserPromptSubmit hook is managed at plugin level and uses ${CLAUDE_PLUGIN_ROOT} 6. User is reminded to restart Claude Code Return structured installation report:

🎯 STARTING: Status Line Manager
Operation: install
───────────────────────────────────────

[Installation output from script]

✅ COMPLETED: Status Line Manager
Installed components:
  • Plugin configuration: .fractary/plugins/status/config.json
  • StatusLine: .claude/settings.json (using absolute path)
  • UserPromptSubmit hook: managed in plugin hooks/hooks.json (uses ${CLAUDE_PLUGIN_ROOT})
  • Scripts: ~/.claude/plugins/marketplaces/fractary/plugins/status/scripts/

Status line format:
  [branch] [±files] [#issue] [PR#pr] [↑ahead ↓behind] last: prompt...

───────────────────────────────────────
Next: Restart Claude Code to activate the status line

## Common Errors

Not in git repository:

Error: Not in a git repository
Solution: Navigate to a git repository before installing

Missing dependencies:

Error: Required dependency not found (jq)
Solution: Install jq: brew install jq (macOS) or apt-get install jq (Linux)

Permission denied:

Error: Cannot write to .claude/ directory
Solution: Check directory permissions, ensure you have write access

StatusLine conflicts:

Info: StatusLine will be updated in .claude/settings.json
Note: Uses absolute path for statusLine (${CLAUDE_PLUGIN_ROOT} only works in plugin-level hooks)

Error Recovery

If installation fails, provide specific error message
Suggest corrective actions
Do not leave project in broken state
Offer to retry or rollback if needed

After successful installation, document: 1. Installation timestamp 2. Installed file locations 3. Hook configuration details 4. Next steps for user 5. Troubleshooting tips ## Example Usage

Install in new project:

/status:install

Expected output:

🎯 STARTING: Status Line Manager
Operation: install
───────────────────────────────────────

Installing Fractary Status Line Plugin...
Creating plugin configuration...
✓ Plugin configuration created
Configuring status line in .claude/settings.json...
✓ StatusLine configured in .claude/settings.json
✓ Added cache file to .gitignore

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ Installation Complete!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Plugin configuration:
  • Configuration: .fractary/plugins/status/config.json
  • Cache location: .fractary/plugins/status/
  • StatusLine: .claude/settings.json (using absolute path)

Plugin Components:
  • StatusLine command: ~/.claude/plugins/marketplaces/fractary/plugins/status/scripts/status-line.sh
  • UserPromptSubmit hook (managed in plugin hooks/hooks.json, uses ${CLAUDE_PLUGIN_ROOT})
  • Scripts: ~/.claude/plugins/marketplaces/fractary/plugins/status/scripts/

✅ COMPLETED: Status Line Manager
───────────────────────────────────────
Next: Restart Claude Code to activate the status line

status-line-manager

Install Skill

SKILL.md