Add Agent Skills support

[altryne]

Summary

Implements support for Agent Skills - reusable prompt templates and scripts that extend AI capabilities for specific tasks. This follows the open Agent Skills specification.

Features

• Skill Discovery: Automatically discovers skills from ~/.chorus/skills/, ~/.claude/skills/, and project-level .chorus/skills/ or .claude/skills/ directories
• SKILL.md Parser: Parses skill files with YAML frontmatter for metadata (name, description, etc.)
• Skills Settings UI: New Settings > Skills tab to view, enable/disable, and configure skills
• System Prompt Injection: Auto-invocation skills are injected into the AI's system prompt so it knows what skills are available
• Slash Command Autocomplete: Type / in chat to see and select available skills
• Skill Tools: skills_use, skills_run_script, and skills_list_scripts tools for AI to invoke skills and execute scripts
• Active Skills Indicator: Shows which skills are currently active in a chat
• Persistent State: Skill enabled/disabled state and invocation mode persisted with debounced writes

Architecture

src/core/chorus/skills/
├── SkillTypes.ts        # Type definitions
├── SkillParser.ts       # SKILL.md frontmatter parser
├── SkillDiscovery.ts    # Multi-location skill discovery
├── SkillManager.ts      # Singleton state manager
└── SkillExecution.ts    # Skill invocation and script execution

src/core/chorus/toolsets/
└── skills.ts            # Skills toolset (skills_use, etc.)

src/ui/components/
├── SkillsSettings.tsx   # Settings tab
├── SkillCard.tsx        # Individual skill card
├── SkillAutocomplete.tsx # Slash command dropdown
└── ActiveSkillsIndicator.tsx # Active skills badges

Documentation

See docs/SKILLS.md for user-facing documentation.

Test plan

• Skill Discovery

  • Create a skill in ~/.claude/skills/test-skill/SKILL.md with valid frontmatter
  • Open Settings > Skills - skill should appear
  • Click refresh - should re-discover skills

• Enable/Disable Skills

  • Toggle a skill off in Settings > Skills
  • Start a new chat - skill should not appear in AI's available skills
  • Toggle back on - skill should reappear

• Auto Invocation Mode

  • Set a skill to "Auto" mode
  • Start a new chat and ask something relevant to that skill
  • AI should mention/use the skill automatically

• Manual Invocation Mode

  • Set a skill to "Manual" mode
  • Start a new chat - AI should NOT automatically use this skill
  • Type /skill-name and press Enter
  • Skill should be loaded into the conversation

• Slash Command Autocomplete

  • In chat input, type /
  • Autocomplete dropdown should appear with enabled skills
  • Use arrow keys to navigate, Enter to select
  • Press Escape to dismiss

• Skills Toolset

  • Enable the Skills toolset
  • Ask AI "What skills do you have?"
  • AI should be able to use skills_use to load a skill

• Script Execution (requires Terminal toolset)

  • Create a skill with a scripts/ folder containing a script
  • Ask AI to run the script
  • AI should use skills_run_script and then terminal to execute

---

🤖 Generated with Claude Code

[greptile-apps]

Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.

[altryne]

@claude review this please 👀 Check for inconsistencies with upstream, check for possible implementation bugs, check for missing docs etc

[altryne]

@bcongdon any interest in adding skills support? What would take for this PR to land in Chorus?