detect-orphaned-skills

Detect orphaned skill files in .agents/skills/ and register them in skills-registry.json.

Updated May 15, 2026
One-click install
npx skills add https://github.com/ruskibeats/t1d --skill detect-orphaned-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: detect-orphaned-skills
Source: https://github.com/ruskibeats/t1d/tree/main/.pi/skills-archive/detect-orphaned-skills
Command: npx skills add https://github.com/ruskibeats/t1d --skill detect-orphaned-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) components.

What problem does it solve?

This Skill identifies and registers skill files that exist on disk but are not listed in the skills registry, ensuring a complete and up-to-date skill inventory.

Core Features & Use Cases

  • Filesystem Analysis: Scans the .agents/skills/ directory for unregistered skill files.
  • Registry Cross-Reference: Compares the filesystem against the skills registry to find discrepancies.
  • Batch Registration: Automates the registration of orphaned skills with appropriate metadata.
  • Use Case: After creating multiple skills or during an audit, use this Skill to ensure all skills are accounted for in the registry.

Quick Start

Run the detect-orphaned-skills skill to automate the detection and registration of orphaned skill files.

Frequently Asked Questions about detect-orphaned-skills

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

FAQPage Schema
How do I find unregistered skill files on disk?

You can find unregistered skill files by performing a filesystem analysis on the .agents/skills/ directory and comparing its contents against skills-registry.json to detect discrepancies.

What is the best way to automate skill registration in Python?

Automating skill registration in Python involves scanning the .agents/skills/ directory for orphaned files and batch registering them with appropriate metadata into skills-registry.json. This ensures a complete and up-to-date skill inventory.

Does skill detection require a specific registry format?

Skill detection requires a skills-registry.json file to exist. The script cross-references the filesystem against this registry to find and register missing skills accurately.

When do I need to run orphaned skill file detection?

You need to run orphaned skill file detection after creating multiple skills manually or during a system audit to ensure all existing skill files on disk are properly accounted for in the skills registry.

Can I use filesystem analysis to fix registry discrepancies in .agents?

Yes, you can use filesystem analysis to fix registry discrepancies in .agents by scanning the skills directory and automatically registering any orphaned skill files found directly into skills-registry.json.