a8fc9c7715
* 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.
1.7 KiB
1.7 KiB
Multi-File Skill Structure
Purpose: Example of a skill with supporting files and scripts
Directory Structure
pdf-processing/
├── SKILL.md # Overview and quick start
├── FORMS.md # Form field mappings
├── REFERENCE.md # API details
└── scripts/
├── fill_form.py # Utility to populate forms
└── validate.py # Check PDFs for required fields
SKILL.md
---
name: pdf-processing
description: Extract text, fill forms, merge PDFs. Use when working with PDF files.
allowed-tools: Read, Bash(python:*)
---
# PDF Processing
## Quick start
Extract text:
```python
import pdfplumber
with pdfplumber.open("doc.pdf") as pdf:
text = pdf.pages[0].extract_text()
For form filling, see FORMS.md (example file). For detailed API reference, see REFERENCE.md (example file).
Requirements
pip install pypdf pdfplumber
---
## Key Patterns
1. **Keep SKILL.md concise** (<500 lines)
2. **Reference supporting files** with markdown links
3. **One level deep** - link directly, avoid nested references
4. **Scripts are executed, not loaded** - saves context tokens
---
## Script Usage
In SKILL.md, tell Claude to run (not read):
```markdown
Run the validation script:
python scripts/validate.py input.pdf
Output goes to Claude, script content stays out of context.
Related
../concepts/agent-skills.md- Skills overview../../lookup/skill-metadata.md- Metadata fields
Reference: https://docs.anthropic.com/en/docs/claude-code/skills