feat(skill): integrate agent skills discovery #414

2026-02-24T12:38:51Z

freemo commented

2026-02-24 12:38:51 +00:00

Summary

Adds the agent skills discovery system that scans configurable filesystem paths for Agent Skills Standard folders (containing SKILL.md with YAML front-matter) and registers them as tools in ToolRegistry. This enables runtime discovery of external agent skills and integrates them into the tool routing pipeline.

Changes

skills/discovery.py: New module implementing path parsing, directory scanning, SKILL.md front-matter parsing, ToolSpec building, and registration with configurable conflict handling (skip/error/replace strategies).
Config: Added skills.agent_skills_paths config key for comma-separated discovery paths.
ToolSpec: Extended with source and source_metadata fields for provenance tracking.
ToolRegistry.list_tools(): Added source filter parameter to query tools by origin.
SkillRegistryService: Rewritten with discover_and_register() and refresh_agent_skills() hooks for on-demand re-scanning.
CLI: Updated agents skill tools command with --refresh flag and source metadata in JSON output.
Documentation: Updated docs/reference/skill_registry.md with Agent Skills Discovery section covering config, algorithm, SKILL.md format, conflict handling, refresh hook, CLI output, and service API.
Tests: 27 Behave scenarios covering config key, path parsing, discovery, ToolSpec building, registration, conflict handling, refresh, and edge cases. 10 Robot Framework integration tests for end-to-end discovery flow. ASV benchmarks for discovery scan performance overhead.

Closes #161

## Summary Adds the agent skills discovery system that scans configurable filesystem paths for Agent Skills Standard folders (containing `SKILL.md` with YAML front-matter) and registers them as tools in `ToolRegistry`. This enables runtime discovery of external agent skills and integrates them into the tool routing pipeline. ### Changes - **`skills/discovery.py`**: New module implementing path parsing, directory scanning, `SKILL.md` front-matter parsing, `ToolSpec` building, and registration with configurable conflict handling (skip/error/replace strategies). - **Config**: Added `skills.agent_skills_paths` config key for comma-separated discovery paths. - **`ToolSpec`**: Extended with `source` and `source_metadata` fields for provenance tracking. - **`ToolRegistry.list_tools()`**: Added `source` filter parameter to query tools by origin. - **`SkillRegistryService`**: Rewritten with `discover_and_register()` and `refresh_agent_skills()` hooks for on-demand re-scanning. - **CLI**: Updated `agents skill tools` command with `--refresh` flag and source metadata in JSON output. - **Documentation**: Updated `docs/reference/skill_registry.md` with Agent Skills Discovery section covering config, algorithm, SKILL.md format, conflict handling, refresh hook, CLI output, and service API. - **Tests**: 27 Behave scenarios covering config key, path parsing, discovery, ToolSpec building, registration, conflict handling, refresh, and edge cases. 10 Robot Framework integration tests for end-to-end discovery flow. ASV benchmarks for discovery scan performance overhead. Closes #161

freemo added this to the v3.1.0 milestone 2026-02-24 12:38:56 +00:00

freemo added the

Type

Feature

label 2026-02-24 12:38:57 +00:00

freemo referenced this pull request

2026-02-24 12:39:33 +00:00

feat(skill): integrate agent skills discovery #161

freemo added a new dependency 2026-02-24 14:27:10 +00:00

#161 feat(skill): integrate agent skills discovery

freemo force-pushed feature/m3-agent-skills-registry from 3a1825148a to 0db0fe6bb2

2026-02-24 14:33:57 +00:00