[BUG] Agent skills: frontmatter field does not inject skill content at startup

Open 💬 0 comments Opened Jun 10, 2026 by ANorwell

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

The skills: field in agent YAML frontmatter is documented to preload skill content into the subagent's context at startup ("The
full skill content is injected, not just the description"), but in practice the content is never injected. The agent starts
without the skill knowledge and must manually invoke the Skill tool to load it.

What Should Happen?

From https://code.claude.com/docs/en/sub-agents#preload-skills-into-subagents:

The full content of each listed skill is injected into the subagent’s context at startup.

Error Messages/Logs

Steps to Reproduce

 Reproduction

  1. Create an agent file with valid skills declared in frontmatter:
  ---
  name: dev
  skills:
    - skill1
    - skill2
  ---
  You are an agent. The skills above are preloaded.

  2. Start a session with this agent (e.g., --agent dev)
  3. Ask the agent: "What's in your context? Were the skills pre-loaded?"


  Actual behavior

  - The agent receives only the body text of the agent file (the prose after the frontmatter)
  - The skill names appear in the "available skills" system-reminder list (same as any session)
  - The skill content is not injected
  - Manually invoking the Skill tool works fine and loads the full content

Claude Model

Opus 4.8

Is this a regression?

Unknown

Last Working Version

_No response_

Claude Code Version

2.1.170.370

Platform

AWS Bedrock

Operating System

Other Linux

Terminal/Shell

Other

Additional Information

_No response_

View original on GitHub ↗