synthesis-skills-manager

Install and track provenance of agent skills across local, project, and user directories.

15|2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/rajivpant/synthesis-skills --skill synthesis-skills-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synthesis-skills-manager
Source: https://github.com/rajivpant/synthesis-skills/tree/main/synthesis-skills-manager
Command: npx skills add https://github.com/rajivpant/synthesis-skills --skill synthesis-skills-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing agent-native skills across multiple repositories and targets is error prone: installations drift, provenance is lost, and text-based merges destroy methodological intent. This Skill centralizes installation, provenance tracking, drift detection, dependency validation, and an AI-guided synthesis merge process so teams and individual agents can keep skills consistent, auditable, and safely customized.

Core Features & Use Cases

  • Install & Sync: Copy skills from public, shared, or private source repos into agent target directories and record provenance with a .source.json file.
  • Drift Detection & Reporting: Compare installed SKILL.md checksums against source commits to surface OK, DRIFT, MISSING, or ORPHAN states.
  • Synthesis Merge: Perform AI-led merges that reconcile methodology-level changes while preserving local customizations and surfacing real conflicts for user decision.
  • Dependency & Access Validation: Enforce the public/shared/private dependency hierarchy and warn about missing or invalid dependencies.
  • Audit & Recovery: Regenerate corrupted provenance, detect circular dependencies, and recommend remediation steps for missing repos.

Quick Start

Request the manager to install or update synthesis skills from your public and private repositories, then run status to detect drift and validate dependencies.

Frequently Asked Questions about synthesis-skills-manager

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

FAQPage Schema
How do I detect drift in installed agent skills across local and project directories?

Skill drift is detected by comparing installed SKILL.md checksums against original source repository commits to report OK, DRIFT, MISSING, or ORPHAN states. This process audits your local, project, and user skill directories against public, shared, and private sources.

What is provenance tracking for AI agent skills and how does it work?

Provenance tracking records the origin and state of agent skills using a .source.json file. It enables accurate auditing and recovery by mapping every installed skill back to its public, shared, or private repository commit.

How do I resolve skill drift without losing local customizations?

Resolve skill drift using an AI-led synthesis merge that reconciles methodology-level changes from the source while preserving local customizations. This process surfaces real conflicts for user decision instead of performing destructive text-based merges.

How do I validate dependencies for agent skills sourced from private and shared repositories?

Validate agent skill dependencies by enforcing the public, shared, and private dependency hierarchy. The system warns about missing or invalid dependencies and detects circular dependencies to ensure your installation is structurally sound.

Can I sync agent skills across multiple agent targets from different repositories?

Yes, you can sync agent skills across multiple targets by copying skills from public, shared, or private source repositories into target directories. The installation process automatically records provenance and validates the dependency hierarchy.

What is the best way to recover corrupted skill provenance files?

Recover corrupted skill provenance by regenerating .source.json files and running an audit to detect circular dependencies. The manager recommends remediation steps for missing repositories to restore full installation integrity.