code-block-examples-test

Detect real reference files cited in SKILL.md while ignoring placeholder examples.

4|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/cuioss/plan-marshall --skill code-block-examples-test
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-block-examples-test
Source: https://github.com/cuioss/plan-marshall/tree/main/test/pm-plugin-development/plugin-doctor/fixtures/skill-structure/code-block-examples
Command: npx skills add https://github.com/cuioss/plan-marshall --skill code-block-examples-test

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill ensures that only real, existing reference files cited in SKILL.md are detected, while placeholder example blocks are ignored.

Core Features & Use Cases

  • Detect real references under the references/ directory and distinguish them from non-existent or illustrative blocks.
  • Validate the SKILL.md frontmatter for name and description to guarantee proper discovery.
  • Support automated discovery in documentation-heavy skills by referencing actual resources and guiding resource loading.

Quick Start

Identify the actual reference file in this skill and summarize its contents.

Frequently Asked Questions about code-block-examples-test

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

FAQPage Schema
How do I validate SKILL.md frontmatter for proper discovery?

To validate SKILL.md frontmatter, ensure the file contains required name and description fields in valid YAML format. This guarantees proper automated discovery and resource loading for documentation-heavy skills.

How do I detect real reference files and ignore placeholder examples in SKILL.md?

Detect real reference files by scanning the references/ directory for actual content while filtering out non-existent or illustrative code blocks cited in SKILL.md. This validation exposes only usable resources.

What is the best way to automate discovery of reference files in a skill directory?

Automate discovery of reference files by validating the SKILL.md frontmatter and scanning optional assets, scripts, and references directories. This process identifies existing resources and guides automated loading.

Does reference validation require a specific directory structure?

Reference validation requires a references/ directory containing actual content and a valid SKILL.md file with YAML frontmatter. Optional assets and scripts directories are also recognized to guide resource loading.

Why are my placeholder example blocks being ignored during reference validation?

Placeholder example blocks are ignored during reference validation because the system distinguishes between non-existent illustrative blocks and real files physically present in the references/ directory.

Can I use this validation for skills without a references directory?

This validation targets skills with a references/ directory containing actual content. Skills lacking this directory structure cannot leverage automated reference discovery and placeholder filtering capabilities.