steering-matcher

Match file paths against steering glob patterns and return prioritized steering files.

41|13|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/rjmurillo/ai-agents --skill steering-matcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: steering-matcher
Source: https://github.com/rjmurillo/ai-agents/tree/main/.claude/skills/steering-matcher
Command: npx skills add https://github.com/rjmurillo/ai-agents --skill steering-matcher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps orchestrators determine which steering guidance applies to the files being modified by matching file paths against steering file front matter patterns. Steering files are prioritized so the most relevant guidance is applied first.

Core Features & Use Cases

  • Pattern-based matching: Compare modified file paths to steering file front matter applyTo patterns.
  • Priority-driven results: Return steering files sorted by priority (highest first) for deterministic guidance.
  • Context-ready output: Produce a list of matching steering files to inject into agent prompts.

Quick Start

Use the Get-ApplicableSteering.ps1 script to find applicable steering for a set of files:

pwsh .claude/skills/steering-matcher/Get-ApplicableSteering.ps1 -Files @("src/claude/analyst.md") -SteeringPath ".agents/steering"

Frequently Asked Questions about steering-matcher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I match file paths against glob patterns for steering guidance?

Pattern matching compares modified file paths to glob patterns in steering file front matter to determine which guidance applies. The skill returns matching steering files sorted by priority, enabling context-aware orchestration based on files being changed.

What is a steering file and how does priority-based matching work?

Steering files contain front matter with `applyTo` glob patterns and priority levels. The skill evaluates file paths against these patterns and returns results sorted by priority (highest first) so the most relevant guidance is injected into agent prompts deterministically.

Can I automate context injection based on which files are modified?

Yes. The skill enables token-efficient context injection by matching modified file paths to steering patterns, returning only applicable guidance. This lets orchestrators inject relevant instructions automatically without redundant or irrelevant context.

Does the steering matcher work with PowerShell automation workflows?

Yes. The skill provides a PowerShell script (Get-ApplicableSteering.ps1) that accepts file paths and a steering directory path, returning applicable steering entries for integration into orchestration and automation pipelines.

What happens if multiple steering files match the same files?

All matching steering files are returned in a single list sorted by priority (highest first). This deterministic ordering ensures the most relevant guidance is considered first, enabling predictable context injection when multiple patterns apply.

Do I need to write glob patterns myself or are they predefined?

You define glob patterns in steering file front matter `applyTo` fields. The skill matches your modified file paths against these patterns you create, so steering guidance is customized to your codebase structure and orchestration requirements.