From 295ddb086eccf7441baed603e8bb49080cd138a2 Mon Sep 17 00:00:00 2001 From: francylisboacharuto Date: Thu, 26 Feb 2026 16:19:34 -0300 Subject: [PATCH] docs: Update registry workflow for corporate teams Initialize built-in registry at ./registry so teams can publish and discover skills without managing a separate repo. Updated README examples to use the simpler default --registry path. Co-Authored-By: Claude Opus 4.6 --- README.md | 78 +++++++++++++++++++++++----------------- registry/registry.json | 8 +++++ registry/skills/.gitkeep | 0 3 files changed, 53 insertions(+), 33 deletions(-) create mode 100644 registry/registry.json create mode 100644 registry/skills/.gitkeep diff --git a/README.md b/README.md index 9adbcdc..28d2832 100644 --- a/README.md +++ b/README.md @@ -284,35 +284,44 @@ Output goes to `exports/`. See [references/export-guide.md](references/export-gu ### Skill Registry -Manage a shared skill catalog for teams using a git-based registry: +Share and discover skills across your team. The registry lives inside this repo (`registry/`) so one `git pull` gives everyone access to all published skills. + +**First-time setup** (once per organization): ```bash -# Initialize a registry -python3 scripts/skill_registry.py init --registry ./my-registry --name "Team Skills" - -# Publish a skill (validates and security-scans first) -python3 scripts/skill_registry.py publish ./my-skill/ --registry ./my-registry --tags data,csv - -# List all published skills -python3 scripts/skill_registry.py list --registry ./my-registry - -# Search for skills -python3 scripts/skill_registry.py search "finance" --registry ./my-registry - -# Show full details about a skill -python3 scripts/skill_registry.py info stock-analyzer --registry ./my-registry - -# Install a skill for a specific platform -python3 scripts/skill_registry.py install stock-analyzer --registry ./my-registry --platform claude-code - -# Install at project level instead of user level -python3 scripts/skill_registry.py install stock-analyzer --registry ./my-registry --project - -# Remove a skill from the registry -python3 scripts/skill_registry.py remove stock-analyzer --registry ./my-registry --force +python3 scripts/skill_registry.py init --name "Acme Corp Skills" ``` -All commands support `--json` for machine-readable output. The registry is a plain directory with `registry.json` and `skills/` — commit it to git for version history, access control via repo permissions, and review workflow via PRs. +**Typical workflow:** + +```bash +# Someone describes a workflow, the agent creates a skill +# "Every week I pull sales data, clean it, and make a report" +# → agent creates ./sales-report-builder/ + +# Publish it so the team can use it +python3 scripts/skill_registry.py publish ./sales-report-builder/ --tags sales,reports + +# Browse what the team has built +python3 scripts/skill_registry.py list +python3 scripts/skill_registry.py search "sales" + +# Get details about a skill +python3 scripts/skill_registry.py info sales-report-builder + +# Install a skill to your platform (auto-detects Claude Code, Cursor, etc.) +python3 scripts/skill_registry.py install sales-report-builder + +# Install for a specific platform or at project level +python3 scripts/skill_registry.py install sales-report-builder --platform cursor --project + +# Remove a skill from the registry +python3 scripts/skill_registry.py remove sales-report-builder --force +``` + +After publishing, commit and push so colleagues can `git pull` and install the new skill. + +All commands support `--json` for machine-readable output. Use `--force` to overwrite duplicates or bypass confirmation prompts. **Exit codes**: `0` = success, `1` = error. @@ -393,14 +402,14 @@ python3 scripts/security_scan.py PATH --json python3 scripts/export_utils.py PATH --variant desktop python3 scripts/export_utils.py PATH --variant api -# Registry -python3 scripts/skill_registry.py init --registry PATH --name NAME -python3 scripts/skill_registry.py publish SKILL_PATH --registry PATH --tags T1,T2 -python3 scripts/skill_registry.py list --registry PATH [--json] -python3 scripts/skill_registry.py search QUERY --registry PATH [--json] -python3 scripts/skill_registry.py install SKILL_NAME --registry PATH --platform PLATFORM -python3 scripts/skill_registry.py info SKILL_NAME --registry PATH [--json] -python3 scripts/skill_registry.py remove SKILL_NAME --registry PATH --force +# Registry (default --registry ./registry) +python3 scripts/skill_registry.py init --name "Team Name" +python3 scripts/skill_registry.py publish SKILL_PATH --tags T1,T2 +python3 scripts/skill_registry.py list [--json] +python3 scripts/skill_registry.py search QUERY [--json] +python3 scripts/skill_registry.py install SKILL_NAME [--platform PLATFORM] [--project] +python3 scripts/skill_registry.py info SKILL_NAME [--json] +python3 scripts/skill_registry.py remove SKILL_NAME --force ``` ### Platform Paths @@ -511,6 +520,9 @@ agent-skill-creator/ templates/ # Skill templates tools/ # Validation and scanning tools examples/ # Example configurations + registry/ # Shared skill catalog (git-tracked) + registry.json # Skill manifest + skills/ # Published skill directories integrations/ agentdb_bridge.py # AgentDB integration bridge fallback_system.py # Graceful degradation system diff --git a/registry/registry.json b/registry/registry.json new file mode 100644 index 0000000..53e759b --- /dev/null +++ b/registry/registry.json @@ -0,0 +1,8 @@ +{ + "registry": { + "name": "Shared Skills", + "created": "2026-02-26T19:19:18+00:00", + "schema_version": "1" + }, + "skills": [] +} diff --git a/registry/skills/.gitkeep b/registry/skills/.gitkeep new file mode 100644 index 0000000..e69de29