skill-register

Promote validated candidate skills from generated/ to production with audit trails.

Updated May 13, 2026
One-click install
npx skills add https://github.com/usetheodev/theo-ui --skill skill-register
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-register
Source: https://github.com/usetheodev/theo-ui/tree/main/.claude/skills/skill-register
Command: npx skills add https://github.com/usetheodev/theo-ui --skill skill-register

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a gate to promote validated candidate skills from staging to production, ensuring governance, auditability, and alignment with validator results.

Core Features & Use Cases

  • Re-validates the candidate against the central validator on every promotion attempt.
  • Enforces no name collisions, preserves audit trails, and moves the skill into production.
  • Supports rollback by returning the skill to generated/ and erasing production changes if needed.

Quick Start

Invoke /skill-register {candidate-name} after a successful /skill-validator PASS to promote the candidate from generated to production.

Frequently Asked Questions about skill-register

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

FAQPage Schema
How do I promote a validated skill to production?

To promote a validated skill to production, invoke the skill-register command on a uniquely named candidate. The tool re-validates the skill, checks for name collisions, moves the directory, and writes an audit trail to the knowledge base.

What happens if an existing first-class skill shares the same name during promotion?

If an existing first-class skill shares the same name, promotion is blocked to prevent collisions. The tool enforces unique naming and requires a successful validator PASS before any candidate skill can be moved into production.

How does skill promotion support rollback after a failed deployment?

Skill promotion supports rollback by recording a pre-move audit trail in the reviews directory. If a production deployment fails, you can return the skill to the generated staging directory and erase the production changes.

Do I need to run the validator before registering a skill?

Yes, you must run the validator and receive a PASS result before registering a skill. The promotion tool re-validates the candidate against the central validator on every attempt to ensure production readiness and governance.

Can I audit the promotion of a candidate skill to first-class status?

Yes, you can audit skill promotion because the tool writes an audit trail to the knowledge base reviews directory before moving the directory. This supports rollback and allows downstream plan consumption to track governance.

Why does my skill promotion fail with a collision check error?

Skill promotion fails with a collision check error when an existing first-class skill already shares the candidate name. You must ensure the candidate skill is uniquely named before the tool can move it to production.