OpenWriterControle/plugins/claude-code/scripts/context/openagents-repo/lookup/skill-metadata.md
Darren Hinde a8fc9c7715
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

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

# Comma-separated
allowed-tools: Read, Grep, Glob

# YAML list
allowed-tools:
  - Read
  - Grep
  - Glob

hooks Syntax

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 ✓ ✗ ✓

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

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