skill-repository-maintainer

Audit, validate, and safely synchronize Codex Skill repositories across devices.

3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/ooooooooooooooooooop/personal-ai --skill skill-repository-maintainer-ooooooooooooooooooop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-repository-maintainer
Source: https://github.com/ooooooooooooooooooop/personal-ai/tree/main/skills/skill-repository-maintainer
Command: npx skills add https://github.com/ooooooooooooooooooop/personal-ai --skill skill-repository-maintainer-ooooooooooooooooooop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Maintaining a Skill backup or release repository requires verifying package structure, manifest consistency, and frontmatter metadata while keeping private runtime files out of published packages, and doing this manually is error-prone. ## Core Features & Use Cases - Structural Auditing: Validates skills.json registry entries, SKILL.md frontmatter, agents/openai.yaml presence, and detects unregistered skill directories. - Safe Synchronization: Runs read-only difference checks against a destination device and only applies changes on explicit request, never deleting extra destination files. - Release Boundary Review: Isolates private memory, caches, machine paths, and generated reports so runtime state never enters published packages. - Use Case: Before publishing a Skill repository, run the strict validator and a read-only sync check against the target device, then report PASS, PARTIAL, or BLOCKED with full evidence. ## Quick Start Ask the agent to audit this Skill repository for completeness, identify files that should not be published, and check whether installed skills match it without deleting anything.

Frequently Asked Questions about skill-repository-maintainer

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

FAQPage Schema
How do I audit a Codex Skill repository for completeness?

Run the strict validator with python3 scripts/validate_repo.py --strict, or use the bundled scripts/audit.py as a portable fallback. It checks skills.json entries, SKILL.md frontmatter, agents/openai.yaml, and flags unregistered skill directories.

How to sync skills to another device without deleting files?

Run scripts/sync_skills.py with --destination and --check first for a read-only diff. Only use --apply when the user explicitly requests it, then run --check again; the sync never deletes extra files on the destination.

What files should be excluded when publishing a skill repository?

Private memory, caches, dependency trees, machine-specific paths, temporary files, and generated reports must be isolated. Runtime state may be audited but must never enter a published package.

Why does the skill audit report unregistered skill directories?

The audit scans the skills directory for folders containing SKILL.md that are not listed in skills.json. Every skill package must be registered in the manifest to pass validation.

What is the difference between skill-repository-maintainer and skill-quality-gate?

skill-repository-maintainer handles structure, registry, boundaries, and synchronization, while skill-quality-gate owns trigger boundaries, output contracts, and behavioral quality. The two skills have explicitly separated responsibilities.