Skip to content
LiveNew tools this week
Submit
AIMarketly
steering-matcher logo

Steering File Matcher Skill

steering-matcher

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.

mattnigh/skills_collection0installs24starsSecurity

SKILL.md

Full skill instructions

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:

  1. Task Analysis: Orchestrator identifies files affected by task
  2. Pattern Matching: Use this skill to find applicable steering
  3. Context Injection: Include matched steering in agent prompt
  4. 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