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

2.1 KiB

Raw Blame History

Skills Troubleshooting

Purpose: Common skill issues and solutions

Skill Not Triggering

Symptom: Claude doesn't use your skill when expected

Cause: Description doesn't match user requests

Solution: Write specific descriptions with trigger terms:

# Bad
description: Helps with documents

# Good  
description: Extract text from PDF files, fill forms, merge documents. Use when working with PDFs, forms, or document extraction.

Tip: Include keywords users would naturally say

Skill Doesn't Load

Check file path:

Type	Correct Path
Personal	`~/.claude/skills/my-skill/SKILL.md`
Project	`.claude/skills/my-skill/SKILL.md`
Plugin	`skills/my-skill/SKILL.md`

Check YAML syntax:

First line must be --- (no blank lines before)
End frontmatter with ---
Use spaces, not tabs

Debug: Run claude --debug to see loading errors

Skill Has Errors

Dependencies not installed:

List required packages in description
User must install before skill works

Script permissions:

chmod +x scripts/*.py

Path format: Use forward slashes (Unix style)

Multiple Skills Conflict

Symptom: Claude uses wrong skill

Cause: Similar descriptions

Solution: Make descriptions distinct:

# Skill 1
description: Analyze sales data in Excel files and CRM exports

# Skill 2  
description: Analyze log files and system metrics

Plugin Skills Not Appearing

Solution: Clear cache and reinstall

rm -rf ~/.claude/plugins/cache
# Restart Claude Code
/plugin install plugin-name@marketplace

Verify structure:

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── my-skill/
        └── SKILL.md

../concepts/agent-skills.md - Skills overview
../guides/creating-skills.md - Creation guide

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

2.1 KiB Raw Blame History