Skip to content

Conversation

@eneufeld
Copy link
Contributor

@eneufeld eneufeld commented Jan 9, 2026

What it does

Implements Agent Skills specification allowing AI agents to access reusable instructions and domain knowledge from SKILL.md files.

Skills are directories containing a SKILL.md file with YAML frontmatter (name, description) and markdown content. The {{skills}} variable resolves to XML listing available skills for injection into agent prompts.

Features:

  • Skill discovery from configured directories and ~/.theia/skills/
  • YAML frontmatter parsing with validation (name, description required)
  • File watching for automatic skill updates
  • {{skills}} variable contribution generating <available_skills> XML
  • Duplicate skill detection with warnings (first directory wins)

New preference:

  • ai-features.skills.skillDirectories: Additional skill directories

Closes #16762

How to test

Add some skill file as described in the readme.
Check that the agent sees the skills if you add {{skills}} variable to its prompt.

Follow-ups

For this feature to be really useful we need to be able to execute js and python (see #16772)

Breaking changes

  • This PR introduces breaking changes and requires careful review. If yes, the breaking changes section in the changelog has been updated.

Attribution

Review checklist

Reminder for reviewers

Implements Agent Skills specification allowing AI agents to access
reusable instructions and domain knowledge from SKILL.md files.

Skills are directories containing a SKILL.md file with YAML frontmatter
(name, description) and markdown content. The {{skills}} variable
resolves to XML listing available skills for injection into agent prompts.

Features:
- Skill discovery from configured directories and ~/.theia/skills/
- YAML frontmatter parsing with validation (name, description required)
- File watching for automatic skill updates
- {{skills}} variable contribution generating <available_skills> XML
- Duplicate skill detection with warnings (first directory wins)

New preference:
- ai-features.skills.skillDirectories: Additional skill directories

Closes #16762
@eneufeld eneufeld requested a review from sdirix January 9, 2026 11:43
@github-project-automation github-project-automation bot moved this to Waiting on reviewers in PR Backlog Jan 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Waiting on reviewers

Development

Successfully merging this pull request may close these issues.

Support Claude Skills

2 participants