feat(plugin): enhance context management and skill invocation (#239 )

* fix(shellcheck): declare and assign separately in router.sh (SC2155)

* feat(plugin): enhance context management and skill invocation

- Update .context-manifest.json to include profile and detailed source information.
- Revise context-scout.md to clarify context root discovery and navigation.
- Modify commands to replace deprecated skills with updated ones (brainstorming → approach, systematic-debugging → debugger).
- Streamline install-context.md for clarity and remove interactive profile selection.
- Improve oac-status.md to provide a more comprehensive status report.
- Add OAC system paths to session-start.sh for better context management.
- Remove obsolete skills and improve documentation for existing commands.

2026-02-23 12:12:29 +00:00

1.7 KiB

Raw Blame History

Agent Skills

Purpose: Markdown files that teach Claude how to do specific tasks

Core Concept

A Skill is a SKILL.md file that teaches Claude specialized knowledge. Skills are model-invoked: Claude automatically applies them based on task context matching the description field.

Key Points

Skills live in ~/.claude/skills/ (personal) or .claude/skills/ (project)
Each skill needs a directory with SKILL.md inside
Name and description in YAML frontmatter are required
Claude loads only name/description at startup (lazy loading)
Full content loaded when skill is activated

Skill File Format

---
name: explaining-code
description: Explains code with diagrams and analogies. Use when explaining how code works.
---

When explaining code, always include:
1. **Start with an analogy**: Compare to everyday life
2. **Draw a diagram**: ASCII art for flow/structure
3. **Walk through the code**: Step-by-step
4. **Highlight a gotcha**: Common mistakes

Where Skills Live

Location	Path	Scope
Enterprise	Managed settings	All org users
Personal	`~/.claude/skills/`	You, all projects
Project	`.claude/skills/`	Anyone in repo
Plugin	Plugin's `skills/`	Plugin users

Priority: Enterprise > Personal > Project > Plugin

../guides/creating-skills.md - How to create skills
../lookup/skill-metadata.md - Metadata fields
../lookup/skills-comparison.md - Skills vs other options

Reference: https://docs.anthropic.com/en/docs/claude-code/skills

1.7 KiB Raw Blame History