skills.rest
ricoyudog
ricoyudogCOMMUNITY
Explore all skills by this author →
GitHub

orphan-skill

Detect skill directories missing required skill.meta.json metadata.

113|9|Updated Apr 30, 2026
Search Tags:#validation#metadata#CI checks#skill registry#workflow reliability
One-click install
npx skills add https://github.com/ricoyudog/Coding_Corgi_flow --skill orphan-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orphan-skill
Source: https://github.com/ricoyudog/Coding_Corgi_flow/tree/main/tools/ds-skills/tests/fixtures/invalid-missing-meta
Command: npx skills add https://github.com/ricoyudog/Coding_Corgi_flow --skill orphan-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps ensure an AI workflow doesn’t silently break when a skill implementation is missing required metadata.

Core Features & Use Cases

  • Detects missing skill metadata: Flags situations where a skill has an entry point but no accompanying skill.meta.json file.
  • Improves reliability of discovery: Prevents orphaned skills from being ignored or malfunctioning in the skill registry.
  • Use Case: When adding a new skill directory, you may accidentally omit required metadata; use this Skill to validate that the skill is properly discoverable before deployment.

Quick Start

Ask the AI to validate that the skill directory contains the required metadata files for successful discovery.

Frequently Asked Questions about orphan-skill

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

FAQPage Schema
How do I validate that a skill directory has the required metadata for discovery?▼

Missing skill metadata causes silent workflow failures when the registry cannot locate the required skill.meta.json file. Without this metadata, the skill becomes orphaned, meaning it will be ignored or malfunction during indexing and activation processes.

How do I detect orphan skill configurations in my repository?▼

Use orphan skill detection to scan directories and flag any skill implementation missing the required skill.meta.json file. This validation step identifies configurations that would cause the registry to ignore or fail to activate the skill.

Can I use metadata validation for CI checks in skill packaging?▼

Yes, you can integrate orphan skill detection into CI checks for skill packaging. The validation enforces skill.meta.json presence requirements, catching missing metadata before deployment to maintain repository hygiene and registry reliability.

Why does my AI skill get ignored by the skill registry?▼

The skill registry ignores AI skills when required skill.meta.json metadata is missing from the directory. This orphaned configuration prevents reliable indexing, causing the skill to be skipped or to malfunction during activation.

What are the limitations of relying on metadata presence for skill registry indexing?▼

Metadata presence validation only checks for skill.meta.json file existence, not schema correctness or content validity. It prevents missing-file registry failures but does not verify that the metadata fields match expected formats or functional requirements.

Related Skills

Explore More Product & Management Skills→
Markson22Markson22

reversa-scout

Map legacy system structure, languages, dependencies, and entry points into a surface.json inventory.

Community
Advanced
tiankong0101-bytetiankong0101-byte

skill-indexer

Rebuild skill registry indexes and validate SKILL.md metadata.

Community
Intermediate
carayacaraya
1

python-core

Review Python codebases for correctness, typing, packaging, and runtime reliability.

Community
Intermediate
jonhill90jonhill90
8

validate-skill

Validate SKILL.md files' frontmatter and structure against the Agent Skills specification.

Community
Intermediate