| name | steering-matcher |
| description | Match file paths against steering file glob patterns to determine applicable steering guidance. Use when orchestrator needs to inject context-aware guidance based on files being modified. |
| license | MIT |
| metadata | null |
| version | 1.0.0 |
| model | claude-haiku-4-5 |
Steering File Matcher Skill
Purpose
This skill helps orchestrator determine which steering files to inject into agent context based on the files being modified.
- Match file paths against glob patterns in steering file front matter
- Return applicable steering files sorted by priority
- Enable token-efficient context injection (30%+ savings)
When to Use
Invoke this skill when you need to:
- Determine which steering guidance applies to a task
- Inject context-aware guidance into agent prompts
- Optimize token usage by scoping guidance to relevant files
- Match files against
applyTo patterns in steering files
Quick Usage
Using Get-ApplicableSteering.ps1 Script
The script in .claude/skills/steering-matcher/Get-ApplicableSteering.ps1 handles pattern matching.
# Match files against steering patterns
$files = @(
"src/claude/analyst.md",
".agents/security/TM-001-auth-flow.md"
)
$steering = pwsh .claude/skills/steering-matcher/Get-ApplicableSteering.ps1 `
-Files $files `
-SteeringPath ".agents/steering"
# Output: Array of hashtables with Name, Path, ApplyTo, Priority
foreach ($s in $steering) {
Write-Host "Matched: $($s.Name) (Priority: $($s.Priority))"
}
Workflow Integration
This skill integrates with the orchestrator workflow:
- Task Analysis: Orchestrator identifies files affected by task
- Pattern Matching: Use this skill to find applicable steering
- Context Injection: Include matched steering in agent prompt
- Token Optimization: Only inject relevant guidance
Standard Orchestrator Workflow
# 1. Identify files from task
$filesAffected = @(
"src/claude/security.md",
".agents/security/SR-001-oauth-review.md"
)
# 2. Get applicable steering
$applicableSteering = pwsh .claude/skills/steering-matcher/Get-ApplicableSteering.ps1 `
-Files $filesAffected
# 3. Inject into agent context
# "Relevant steering: agent-prompts.md (Priority 9), security-practices.md (Priority 10)"
Implementation
See Get-ApplicableSteering.ps1 for the PowerShell implementation.
Testing
Run Pester tests to verify pattern matching:
Invoke-Pester .claude/skills/steering-matcher/tests/Get-ApplicableSteering.Tests.ps1
Related
