sync-skills-repo-guidance

Audit skills-export repositories for guidance drift and missing mirror references.

6|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/gaelic-ghost/socket --skill sync-skills-repo-guidance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-skills-repo-guidance
Source: https://github.com/gaelic-ghost/socket/tree/main/plugins/agent-plugin-skills/skills/sync-skills-repo-guidance
Command: npx skills add https://github.com/gaelic-ghost/socket --skill sync-skills-repo-guidance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Audit and align a skills-export repository against current governance guidance to surface drift, missing mirror references, and outdated guidance across README.md, AGENTS.md, and maintainer docs.

Core Features & Use Cases

  • Audit root and maintainer docs to ensure discovery mirrors and guidance are up to date with Agent Skills standards and Codex/Claude references.
  • Flag missing or stale references in README.md, AGENTS.md, reality-audit, and discovery mirrors, and enforce repository surface constraints (no nested staged plugin directories, proper manifests).
  • Generate actionable findings that guide maintainers to remediate guidance drift and align with current policy.

Quick Start

Run the audit against a target skills repository to surface guidance drift and generate a findings report.

Frequently Asked Questions about sync-skills-repo-guidance

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

FAQPage Schema
How do I audit a skills repository for guidance drift and missing mirrors?

To audit a skills repository for guidance drift, you can run this skill against your root and maintainer docs to surface missing mirror references and outdated guidance across README.md and AGENTS.md files, generating an actionable findings report.

What is skills repository guidance drift and how do I detect it?

Skills repository guidance drift occurs when maintainer docs and discovery mirrors fall out of sync with current standards. You detect it by auditing root files like README.md and AGENTS.md to flag stale references and outdated policy documentation.

Can I use this audit to check for nested staged plugin directories in my repo?

Yes, you can use this audit to enforce repository surface constraints, which specifically checks for improper manifests and flags any nested staged plugin directories that violate current repository structure policies.

Does the audit check both README.md and AGENTS.md for stale Codex and Claude references?

Yes, the audit checks both README.md and AGENTS.md files to ensure that discovery mirrors and guidance references remain fully up to date with current Agent Skills standards and Codex or Claude references.

What is the best way to align existing skills repositories with current governance guidance?

The best way to align existing skills repositories with current governance guidance is to run an audit that identifies drift in maintainer docs and generates actionable findings to guide your remediation of outdated policy.

Why does my skills repository audit flag missing discovery mirror references?

Your skills repository audit flags missing discovery mirror references because it enforces repository surface constraints by actively checking for stale or absent mirror links within your root documentation and maintainer guides.