CtrlK
BlogDocsLog inGet started
Tessl Logo

generate-path-instructions

Generates path-specific instruction files (.github/instructions/*.md) with JIT loading via applyTo glob patterns. Performs LLM-driven repository analysis to discover file patterns and extract scope-specific rules. Use when the user requests scoped, framework-specific, or directory-specific rules for testing, components, docs, config files, or language-specific files to prevent context pollution. Works for code, documentation, configuration, and data files.

71

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is generate-path-instructions in canonical/copilot-collections

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured skill body: a sequenced 7-step workflow with explicit validation and refinement loops, and exemplary progressive disclosure that pulls each reference in exactly when needed and documents bundle files accurately. The main defects are minor: some redundant overview text, and Step 6 validation commands that reference non-bundled script paths with an inconsistent skill-name suffix.

Suggestions

Fix Step 6's script paths: use the bundled 'scripts/test_glob_pattern.py' consistently instead of '.github/skills/generate-path-instructions-v2/scripts/test_glob_pattern.py', and either bundle or drop the reference to '.github/skills/generate-agent-skills/scripts/validate_skill.py'.

Trim the Overview section, which restates the frontmatter description, and compress the emoji output template in Step 6 to its essential fields.

DimensionReasoningScore

Conciseness

The 7-step workflow is efficient with Goal/Output framing and no tutoring on concepts Claude already knows, but the Overview section partially restates the frontmatter description and a few lines (e.g., the emoji output template) could be trimmed. Matches anchor 4: minor over-explanation that could be tightened, not the lean every-token-earns-its-place profile of anchor 5.

4 / 5

Actionability

Mostly executable guidance: 'cat references/scope_analysis_checklist.md', 'python3 scripts/test_glob_pattern.py --pattern "tests/**/*.py" --limit 10' (flags verified against the script's argparse), and concrete decision trees. The gap is Step 6, where two of three commands point at scripts not in the bundle ('.github/skills/generate-agent-skills/scripts/validate_skill.py' and '.github/skills/generate-path-instructions-v2/scripts/test_glob_pattern.py' — the '-v2' suffix contradicts this skill's own name). Not 3 because the majority of commands are copy-paste ready with correct syntax.

4 / 5

Workflow Clarity

Seven clearly sequenced steps each with an explicit Goal, decision points ('Be specific or accept ambiguity?'), and per-step outputs; Step 6 is a dedicated validation stage with a final checklist, and Step 7 provides error-recovery refinement loops ('Pattern too broad → Add path prefix'). This matches anchor 5: explicit validation steps, feedback loops, and checklists for a complex process.

5 / 5

Progressive Disclosure

The body is a clear overview that loads each reference at the exact step where it is needed ('Load the scope analysis checklist: cat references/scope_analysis_checklist.md'), all five references plus the script exist in the bundle and are one level deep, and the Resources section summarizes each file. The script's documented interface (--pattern, --limit) matches its actual CLI. This matches anchor 5: well-signaled, one-level-deep, easy navigation.

5 / 5

Total

18

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete multi-action 'what', an explicit 'Use when' clause with specific trigger domains, and a clearly staked niche around path-specific instruction files with applyTo glob patterns. The only weakness is that trigger-term coverage, while good, lacks synonyms and extension-level terms that would push it to fully comprehensive.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Generates path-specific instruction files (.github/instructions/*.md) with JIT loading via applyTo glob patterns', 'Performs LLM-driven repository analysis to discover file patterns and extract scope-specific rules' — covering generation, pattern construction, analysis, and rule extraction comprehensively, matching the anchor-5 example structure.

5 / 5

Completeness

Explicitly answers both: what ('Generates path-specific instruction files... Performs LLM-driven repository analysis... extract scope-specific rules') and when ('Use when the user requests scoped, framework-specific, or directory-specific rules for testing, components, docs, config files, or language-specific files'), matching the anchor-5 pattern with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural trigger phrases ('scoped, framework-specific, or directory-specific rules for testing, components, docs, config files') but coverage is not comprehensive — missing common synonyms and extension-based triggers users might naturally say. Not 3 since the keywords present are relevant and specific rather than generic.

4 / 5

Distinctiveness Conflict Risk

A clear niche is staked out via '.github/instructions/*.md' and 'applyTo glob patterns' with JIT loading, but the broad trigger topics (testing, components, docs, config) create minor overlap risk with a closely related global repo-instructions skill. Not 5 because of that sibling-skill overlap; not 3 because the mechanism and scope are distinctly stated.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
canonical/copilot-collections
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.