scoped-skill

Test scoped scanning effects on skill discovery with SKILL.md frontmatter.

12|2|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/aws-samples/sample-agent-skill-eval --skill scoped-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scoped-skill
Source: https://github.com/aws-samples/sample-agent-skill-eval/tree/main/tests/fixtures/scoped-skill
Command: npx skills add https://github.com/aws-samples/sample-agent-skill-eval --skill scoped-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Demonstrates how scoped scanning affects skill discovery and execution in an agent environment, helping teams diagnose discovery scope issues.

Core Features & Use Cases

  • Scoped discovery testing: ensures only intended files are scanned during skill discovery and loading
  • Resource awareness: detects and leverages optional components (scripts, references) to exercise the discovery pipeline
  • Debug and validation: provides a controlled fixture to compare scoped vs full scanning scenarios in automated tests

Quick Start

Run the provided processor script to observe how input is transformed under scoped scanning.

Frequently Asked Questions about scoped-skill

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

FAQPage Schema
What is scoped scanning and how does it affect skill discovery?

Scoped scanning limits skill discovery to intended files and directories, ensuring only relevant resources are loaded. It validates discovery behavior by verifying SKILL.md frontmatter and recognizing optional directories like scripts and references.

How do I test partial-scoped versus full-scan workflows for agent skills?

You can test partial-scoped versus full-scan workflows by running the provided processor script in a controlled fixture environment. This compares discovery behavior across skills and validates how resources are loaded under different scanning scopes.

Does scoped scanning work with optional directories like scripts and references?

Yes, scoped scanning recognizes optional directories such as scripts and references during the discovery pipeline. It detects and leverages these components to exercise resource awareness and validate the loading behavior.

Why does my agent skill discovery scan unintended files?

Skill discovery may scan unintended files if scoped scanning is not properly configured. Using a controlled testing fixture helps diagnose discovery scope issues by comparing partial-scoped versus full-scan workflows to isolate the problem.

Can I use this fixture to validate SKILL.md frontmatter in automated tests?

Yes, you can use this fixture in automated tests to validate the presence of a valid SKILL.md frontmatter with name and description. It provides a controlled environment to verify discovery pipeline behavior and exercise component recognition.

What's the best way to debug agent skill discovery scope issues?

The best way to debug agent skill discovery scope issues is to use a controlled fixture that compares partial-scoped versus full-scan workflows. This helps diagnose discovery behavior and validates that only intended files are scanned during loading.