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.
76 lines
1.7 KiB
Markdown
76 lines
1.7 KiB
Markdown
<!-- Context: openagents-repo/lookup | Priority: high | Version: 1.0 | Updated: 2026-02-15 -->
|
|
|
|
# Skill Metadata Fields
|
|
|
|
**Purpose**: Quick reference for SKILL.md frontmatter fields
|
|
|
|
---
|
|
|
|
## Required Fields
|
|
|
|
| Field | Description |
|
|
|-------|-------------|
|
|
| `name` | Unique identifier (lowercase, hyphens, max 64 chars) |
|
|
| `description` | What skill does and when to use (max 1024 chars) |
|
|
|
|
---
|
|
|
|
## Optional Fields
|
|
|
|
| Field | Default | Description |
|
|
|-------|---------|-------------|
|
|
| `allowed-tools` | All | Tools Claude can use without permission |
|
|
| `model` | Conversation | Model to use (e.g., `claude-sonnet-4-20250514`) |
|
|
| `context` | - | Set to `fork` for isolated sub-agent context |
|
|
| `agent` | `general-purpose` | Agent type when `context: fork` |
|
|
| `hooks` | - | Lifecycle hooks (`PreToolUse`, `PostToolUse`, `Stop`) |
|
|
| `user-invocable` | `true` | Show in slash command menu |
|
|
| `disable-model-invocation` | `false` | Block programmatic invocation |
|
|
|
|
---
|
|
|
|
## allowed-tools Syntax
|
|
|
|
```yaml
|
|
# Comma-separated
|
|
allowed-tools: Read, Grep, Glob
|
|
|
|
# YAML list
|
|
allowed-tools:
|
|
- Read
|
|
- Grep
|
|
- Glob
|
|
```
|
|
|
|
---
|
|
|
|
## hooks Syntax
|
|
|
|
```yaml
|
|
hooks:
|
|
PreToolUse:
|
|
- matcher: "Bash"
|
|
hooks:
|
|
- type: command
|
|
command: "./scripts/validate.sh"
|
|
once: true # Run only once per session
|
|
```
|
|
|
|
---
|
|
|
|
## Visibility Control
|
|
|
|
| Setting | Slash Menu | Skill Tool | Auto-discovery |
|
|
|---------|------------|------------|----------------|
|
|
| Default | ✓ | ✓ | ✓ |
|
|
| `user-invocable: false` | ✗ | ✓ | ✓ |
|
|
| `disable-model-invocation: true` | ✓ | ✗ | ✓ |
|
|
|
|
---
|
|
|
|
## Related
|
|
|
|
- `../concepts/agent-skills.md` - Skills overview
|
|
- `../guides/creating-skills.md` - Creation guide
|
|
|
|
**Reference**: https://docs.anthropic.com/en/docs/claude-code/skills
|