Agent skill
skill-library-manager
Manage Claude skills lifecycle in the Skills_librairie repository at /Users/guillaumebld/Documents/Skills/Skills_librairie. Skills are organized in Skills/ directory by category (Meta-skill/, Automation/, Infrastructure-DevOps/, Development/, Design-Creative/, Communication/, Document-Generation/, AI-Agents/). Create new skills following best practices, search existing skills, manage versions with semantic versioning, sync with GitHub (GuillaumeBld/Skills_librairie), and install skills to Claude.ai or local directories. Use when creating skills for this specific library, searching for existing skills, updating skill versions, syncing with GitHub, or organizing your skill collection. Requires GitHub CLI (gh) for authentication. Repository path: /Users/guillaumebld/Documents/Skills/Skills_librairie
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/skill-library-manager
SKILL.md
Skill Library Manager
Complete lifecycle management for Claude skills in the Skills_librairie repository.
Repository-Specific Configuration:
- Repository Path:
/Users/guillaumebld/Documents/Skills/Skills_librairie - GitHub Repository:
https://github.com/GuillaumeBld/Skills_librairie.git - Skills Location:
Skills/directory (capital S) organized by category - Categories: Meta-skill, Automation, Infrastructure-DevOps, Development, Design-Creative, Communication, Document-Generation, AI-Agents
- Catalog: Auto-generated
catalog.jsonat repository root
This skill is specifically designed to manage skills within this repository structure. All paths and commands assume you are working within /Users/guillaumebld/Documents/Skills/Skills_librairie.
Prerequisites
- GitHub CLI (
gh) installed and authenticated - Git installed
- Python 3.8+ (for catalog operations)
- Access to https://github.com/GuillaumeBld/Skills_librairie.git
First-Time Setup
# Repository location: /Users/guillaumebld/Documents/Skills/Skills_librairie
# 1. Install GitHub CLI (if not already installed)
# macOS: brew install gh
# Linux: See https://github.com/cli/cli/blob/trunk/docs/install_linux.md
# Windows: winget install --id GitHub.cli
# 2. Authenticate
gh auth login
# 3. Navigate to repository
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# 4. Verify structure
ls Skills/
# Expected categories: Meta-skill/, Automation/, Infrastructure-DevOps/, Development/, Design-Creative/, Communication/, Document-Generation/, AI-Agents/
# 5. Test GitHub access
gh repo view GuillaumeBld/Skills_librairie
Quick Start: Complete Workflow
1. Initialize Library (First Use)
# Repository is located at: /Users/guillaumebld/Documents/Skills/Skills_librairie
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# Verify structure
ls Skills/
# Expected categories: Meta-skill/, Automation/, Infrastructure-DevOps/, Development/, Design-Creative/, Communication/, Document-Generation/, AI-Agents/
# Each category contains skill directories, e.g.:
# Skills/Meta-skill/skill-library-manager/
# Skills/Automation/n8n-workflow-patterns/
# Skills/Infrastructure-DevOps/vps-deployment-stack/
If catalog.json doesn't exist at the repository root, create it:
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
cat > catalog.json << 'EOF'
{
"version": "1.0.0",
"updated": "2026-01-10",
"repository": "https://github.com/GuillaumeBld/Skills_librairie",
"skills": []
}
EOF
2. Create New Skill
Use scripts/create-skill.sh to automate the full workflow.
Example: Create a PostgreSQL backup skill in Infrastructure-DevOps category
# Run creation script from skill-library-manager
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
bash Skills/skill-library-manager/scripts/create-skill.sh
# Interactive prompts:
# Skill name: postgres-backup
# Category: Infrastructure-DevOps
# Description: Automate PostgreSQL backups with pg_dump and S3 upload
# Author: Guillaume
# Tags: database, backup, postgresql, s3
# Version: 1.0.0
# Script will:
# 1. Create skill structure in Skills/Infrastructure-DevOps/postgres-backup/
# 2. Open editor for SKILL.md
# 3. Validate skill structure
# 4. Update catalog.json at repository root
# 5. Git commit + push
# 6. Create Git tag (postgres-backup-v1.0.0)
Manual workflow:
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# 1. Choose category (e.g., Infrastructure-DevOps, Meta-skill, Automation, etc.)
CATEGORY="Infrastructure-DevOps"
SKILL_NAME="postgres-backup"
# 2. Create skill directory structure
mkdir -p Skills/${CATEGORY}/${SKILL_NAME}/{scripts,references,assets}
# 3. Create SKILL.md with frontmatter
cat > Skills/${CATEGORY}/${SKILL_NAME}/SKILL.md << 'EOF'
---
name: postgres-backup
description: Automate PostgreSQL backups with pg_dump and S3 upload
---
# Postgres Backup
[Your skill instructions here]
EOF
# 4. Update catalog using the skill-library-manager script
python3 Skills/skill-library-manager/scripts/catalog-builder.py
# 5. Commit and push
git add Skills/${CATEGORY}/${SKILL_NAME}
git add catalog.json
git commit -m "Add ${SKILL_NAME} skill v1.0.0 to ${CATEGORY} category"
git tag ${SKILL_NAME}-v1.0.0
git push origin main --tags
3. Search Skills
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# Search by keyword
python3 Skills/skill-library-manager/scripts/search-skills.py database
# Search by tag
python3 Skills/skill-library-manager/scripts/search-skills.py --tag backup
# Search by category
python3 Skills/skill-library-manager/scripts/search-skills.py --category Infrastructure-DevOps
# List all skills
python3 Skills/skill-library-manager/scripts/search-skills.py --all
# Output example:
# Found 3 skills matching "database":
#
# 1. postgres-backup (v1.0.0)
# Category: Infrastructure-DevOps
# Description: Automate PostgreSQL backups with pg_dump and S3 upload
# Tags: database, backup, postgresql, s3
# Location: Skills/Infrastructure-DevOps/postgres-backup/
#
# 2. mysql-monitoring (v2.1.0)
# Category: Infrastructure-DevOps
# Description: Monitor MySQL performance metrics and slow queries
# Tags: database, monitoring, mysql
# Location: Skills/Infrastructure-DevOps/mysql-monitoring/
# ...
4. Install Skill
Option A: Install to Claude.ai (Manual)
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# Skills in this repository are organized as directories, not .skill packages
# Navigate to the skill directory
cd Skills/Infrastructure-DevOps/postgres-backup
# If you need to package it first, use the skill-creator tools:
# (Note: Check if package_skill.py is available in Meta-skill/skill-creator/scripts/)
# Upload in Claude.ai:
# - Profile → Skills → Upload Skill
# - Select the skill directory (Skills/Infrastructure-DevOps/postgres-backup/)
# - Or zip it first: zip -r postgres-backup.zip Skills/Infrastructure-DevOps/postgres-backup/
# - Confirm installation
Option B: Install to Local Directory (Codex Skills)
# For Codex/Claude Code, skills should be in ~/.codex/skills/
# Create category directory if needed
mkdir -p ~/.codex/skills/Infrastructure-DevOps
# Copy skill folder from repository
cp -r /Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/Infrastructure-DevOps/postgres-backup \
~/.codex/skills/Infrastructure-DevOps/
# Or create symlink for development
ln -s /Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/Infrastructure-DevOps/postgres-backup \
~/.codex/skills/Infrastructure-DevOps/postgres-backup
5. Update Existing Skill
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# 1. Navigate to the skill (organized by category)
cd Skills/Infrastructure-DevOps/vps-deployment-stack
# Edit SKILL.md, add scripts, references, assets, etc.
# 2. Update version in SKILL.md frontmatter
# In the frontmatter, add or update version: 1.1.0
# 3. Create or update CHANGELOG.md (optional but recommended)
cat >> CHANGELOG.md << 'EOF'
## v1.1.0 - 2026-01-15
- Added backup automation scripts
- Improved troubleshooting guide
EOF
# 4. Update catalog to reflect new version
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
python3 Skills/skill-library-manager/scripts/catalog-builder.py
# 5. Commit with version bump
git add Skills/Infrastructure-DevOps/vps-deployment-stack
git add catalog.json
git commit -m "Update vps-deployment-stack to v1.1.0"
git tag vps-deployment-stack-v1.1.0
git push origin main --tags
6. Sync Library
# Pull latest changes from GitHub
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
git pull origin main --tags
# Push local changes
git push origin main --tags
# Or use the sync script
bash Skills/skill-library-manager/scripts/sync-library.sh
Workflows
Workflow 1: "I need a skill for X, let me check if I have one"
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# Search your library
python3 Skills/skill-library-manager/scripts/search-skills.py "kubernetes deployment"
# Or search by browsing categories
ls Skills/Infrastructure-DevOps/
ls Skills/Automation/
# etc.
# If found: Reference it from Skills/{category}/{skill-name}/
# If not found: Create it (see Workflow 2)
Workflow 2: "Create a new skill and save it"
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# Option A: Automated (recommended)
bash Skills/skill-library-manager/scripts/create-skill.sh
# Follow prompts: name, category, description, tags, version
# Option B: Manual (more control)
# 1. Choose category (Meta-skill, Automation, Infrastructure-DevOps, Development, Design-Creative, Communication, Document-Generation, AI-Agents)
CATEGORY="Meta-skill" # or appropriate category
SKILL_NAME="my-new-skill"
# 2. Create directory structure
mkdir -p Skills/${CATEGORY}/${SKILL_NAME}/{scripts,references,assets}
# 3. Create SKILL.md with frontmatter (use Skills/skill-library-manager/references/skill-template.md as reference)
# Edit content
code Skills/${CATEGORY}/${SKILL_NAME}/SKILL.md
# 4. Update catalog
python3 Skills/skill-library-manager/scripts/catalog-builder.py
# 5. Commit
git add Skills/${CATEGORY}/${SKILL_NAME}
git add catalog.json
git commit -m "Add ${SKILL_NAME} v1.0.0 to ${CATEGORY} category"
git tag ${SKILL_NAME}-v1.0.0
git push origin main --tags
Workflow 3: "Share skill with team"
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# 1. Ensure skill is pushed to GitHub
git push origin main --tags
# 2. Share repository URL
# Team members clone:
# cd ~/Documents/Skills
# gh repo clone GuillaumeBld/Skills_librairie
# 3. Or share the specific skill directory
# Team members can reference: Skills/{category}/{skill-name}/
# Or zip it: zip -r my-skill.zip Skills/Infrastructure-DevOps/my-skill/
Workflow 4: "Update skill after improvements"
See section 5 above (Update Existing Skill).
Workflow 5: "Browse all skills in library"
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# List all with metadata
python3 Skills/skill-library-manager/scripts/search-skills.py --all
# View catalog directly (if it exists)
cat catalog.json | jq '.skills' 2>/dev/null || echo "catalog.json not found, run catalog-builder.py"
# Browse by category
tree -L 2 Skills/ # Shows all categories and their skills
# Or manually:
ls -la Skills/*/
# Browse on GitHub
gh repo view GuillaumeBld/Skills_librairie --web
# Or open in file browser
open Skills/
Repository Structure
This Skills_librairie repository follows this structure:
/Users/guillaumebld/Documents/Skills/Skills_librairie/
├── README.md # Library overview
├── catalog.json # Searchable skill index (auto-generated)
├── .gitignore # Git ignore rules
├── Skills/ # All skills organized by category
│ ├── Meta-skill/ # Skills for managing skills
│ │ ├── skill-library-manager/ # This skill
│ │ │ ├── SKILL.md
│ │ │ ├── scripts/
│ │ │ │ ├── create-skill.sh
│ │ │ │ ├── catalog-builder.py
│ │ │ │ ├── search-skills.py
│ │ │ │ └── sync-library.sh
│ │ │ ├── references/
│ │ │ └── assets/
│ │ ├── skill-creator/
│ │ ├── skill-quality-auditor/
│ │ └── ...
│ ├── Automation/ # n8n and workflow automation skills
│ │ ├── n8n-workflow-patterns/
│ │ ├── n8n-expression-syntax/
│ │ └── ...
│ ├── Infrastructure-DevOps/ # VPS, Docker, deployment skills
│ │ ├── vps-deployment-stack/
│ │ ├── vps-daily-operations/
│ │ ├── docker-development-workflow/
│ │ └── ...
│ ├── Development/ # Development tools and workflows
│ ├── Design-Creative/ # Design and creative skills
│ ├── Communication/ # Communication and branding skills
│ ├── Document-Generation/ # Document creation skills (docx, pdf, pptx, xlsx)
│ └── AI-Agents/ # AI agent and RAG skills
│ └── rag-pipeline-expert/
└── (scripts are within skill-library-manager)
Key points:
- All skills are in
Skills/directory (capital S) - Skills are organized by category subdirectories
- Each skill is a directory containing
SKILL.md, optionalscripts/,references/,assets/ - Management scripts are in
Skills/Meta-skill/skill-library-manager/scripts/ - Catalog is auto-generated at repository root
Catalog Schema
catalog.json structure (located at repository root):
{
"version": "1.0.0",
"updated": "2026-01-15T10:30:00Z",
"repository": "https://github.com/GuillaumeBld/Skills_librairie",
"repository_path": "/Users/guillaumebld/Documents/Skills/Skills_librairie",
"skills": [
{
"name": "vps-deployment-stack",
"category": "Infrastructure-DevOps",
"version": "1.1.0",
"description": "Deploy Dokploy + Traefik + Docker + Kuma with automatic HTTPS",
"author": "Guillaume",
"created": "2026-01-10",
"updated": "2026-01-15",
"tags": ["devops", "docker", "vps", "deployment", "traefik"],
"dependencies": [],
"compatibility": ["claude.ai", "claude-code"],
"license": "MIT",
"location": "Skills/Infrastructure-DevOps/vps-deployment-stack/",
"absolute_path": "/Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/Infrastructure-DevOps/vps-deployment-stack"
},
{
"name": "skill-library-manager",
"category": "Meta-skill",
"version": "1.0.0",
"description": "Manage Claude skills lifecycle in the Skills_librairie repository",
"author": "Guillaume",
"created": "2026-01-10",
"updated": "2026-01-15",
"tags": ["meta", "skill-management", "catalog", "github"],
"dependencies": [],
"compatibility": ["claude.ai", "claude-code"],
"license": "MIT",
"location": "Skills/Meta-skill/skill-library-manager/",
"absolute_path": "/Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/Meta-skill/skill-library-manager"
}
],
"categories": {
"Meta-skill": ["skill-library-manager", "skill-creator", "skill-quality-auditor"],
"Infrastructure-DevOps": ["vps-deployment-stack", "vps-daily-operations", "docker-development-workflow"],
"Automation": ["n8n-workflow-patterns", "n8n-expression-syntax", "n8n-mcp-tools-expert"],
"AI-Agents": ["rag-pipeline-expert"]
}
}
Catalog Generation:
- Generated automatically by
Skills/skill-library-manager/scripts/catalog-builder.py - Scans
Skills/directory for allSKILL.mdfiles - Extracts metadata from frontmatter
- Organizes by category structure
Versioning Strategy
Follow Semantic Versioning (semver):
- Major (x.0.0): Breaking changes, incompatible updates
- Minor (1.x.0): New features, backward compatible
- Patch (1.0.x): Bug fixes, minor improvements
Examples:
1.0.0→1.0.1: Fixed typo in SKILL.md1.0.1→1.1.0: Added new reference file1.1.0→2.0.0: Restructured skill, changed interface
Git Tags:
- Format:
{skill-name}-v{version} - Example:
postgres-backup-v1.0.0 - List tags:
git tag -l "postgres-backup-*"
GitHub Operations
Common Commands
# Repository location: /Users/guillaumebld/Documents/Skills/Skills_librairie
# Clone library (if starting fresh)
cd /Users/guillaumebld/Documents/Skills
gh repo clone GuillaumeBld/Skills_librairie
# View repository
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
gh repo view GuillaumeBld/Skills_librairie
# Create issue (for skill requests)
gh issue create --repo GuillaumeBld/Skills_librairie --title "Request: New skill for X" --body "Description of needed skill"
# List releases
gh release list --repo GuillaumeBld/Skills_librairie
# Create release (for major versions)
gh release create v1.0.0 --repo GuillaumeBld/Skills_librairie --title "Skills Library v1.0.0" --notes "Initial release"
# View repository in browser
gh repo view GuillaumeBld/Skills_librairie --web
Backup Strategy
# Repository is at: /Users/guillaumebld/Documents/Skills/Skills_librairie
# Create timestamped backup
BACKUP_DIR=~/Backups/Skills_librairie-$(date +%Y%m%d)
mkdir -p ~/Backups
cp -r /Users/guillaumebld/Documents/Skills/Skills_librairie "$BACKUP_DIR"
# Or create compressed archive
cd /Users/guillaumebld/Documents/Skills
tar -czf ~/Backups/skills-library-$(date +%Y%m%d).tar.gz Skills_librairie/
# Or clone to backup location
gh repo clone GuillaumeBld/Skills_librairie ~/Backups/Skills_librairie-backup-$(date +%Y%m%d)
Best Practices
1. Skill Naming
- Use kebab-case:
postgres-backup,vps-deployment - Be descriptive:
docker-dev-workflownotdocker-skill - Avoid generic names:
database-utils→postgres-backup-automation
2. Documentation
- Always include SKILL.md with clear description
- Add CHANGELOG.md for version history
- Include README.md in complex skills
- Document prerequisites clearly
3. Tagging
- Use 3-5 relevant tags per skill
- Common tags: devops, database, monitoring, backup, security, docker, kubernetes
- Consistent naming:
postgresqlnotpostgres,backupnotbackups
4. Versioning
- Start at v1.0.0 for production-ready skills
- Use v0.x.x for experimental/beta skills
- Always update CHANGELOG.md with version bumps
- Tag releases in Git
5. Organization
- Group related skills in catalog categories
- Keep skills focused (single responsibility)
- Extract common patterns into separate skills
- Document skill dependencies
Troubleshooting
Library Not Found
# Repository should be at: /Users/guillaumebld/Documents/Skills/Skills_librairie
# Check if exists
ls -la /Users/guillaumebld/Documents/Skills/Skills_librairie
# If not, clone
cd /Users/guillaumebld/Documents/Skills
gh repo clone GuillaumeBld/Skills_librairie
GitHub Authentication Failed
# Re-authenticate
gh auth login
# Check status
gh auth status
# Test access
gh repo view GuillaumeBld/Skills_librairie
Catalog Out of Sync
# Rebuild catalog from Skills/ directory
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
python3 Skills/skill-library-manager/scripts/catalog-builder.py
# Commit updated catalog
git add catalog.json
git commit -m "Rebuild catalog from Skills/ directory structure"
git push
Merge Conflicts
# Pull latest changes first
git pull origin main
# If conflicts, resolve manually
git status
# Edit conflicting files
git add .
git commit -m "Resolve merge conflicts"
git push
Skill Validation Fails
cd /Users/guillaumebld/Documents/Skills/Skills_librairie
# Check skill structure manually
CATEGORY="Meta-skill" # or appropriate category
SKILL_NAME="my-skill"
ls -la Skills/${CATEGORY}/${SKILL_NAME}/
# Verify SKILL.md exists and has valid frontmatter
head -10 Skills/${CATEGORY}/${SKILL_NAME}/SKILL.md
# Common issues:
# - Missing SKILL.md in skill directory
# - Invalid YAML frontmatter (missing --- markers, syntax errors)
# - Missing name or description in frontmatter
# - Skill directory not in correct category location
# - Files outside expected structure (scripts/, references/, assets/ are optional)
Reference Files
All reference files are located in Skills/skill-library-manager/:
- scripts/create-skill.sh - Automated skill creation workflow
- Location:
/Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/skill-library-manager/scripts/create-skill.sh
- Location:
- scripts/catalog-builder.py - Generate/update catalog.json from Skills/ directory
- Location:
/Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/skill-library-manager/scripts/catalog-builder.py
- Location:
- scripts/search-skills.py - Search catalog by keywords/tags/category
- Location:
/Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/skill-library-manager/scripts/search-skills.py
- Location:
- scripts/sync-library.sh - Git pull + push wrapper
- Location:
/Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/skill-library-manager/scripts/sync-library.sh
- Location:
- references/skill-template.md - Template for new skills
- Location:
/Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/skill-library-manager/references/skill-template.md
- Location:
- references/github-workflow.md - Detailed GitHub operations
- Location:
/Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/skill-library-manager/references/github-workflow.md
- Location:
- references/versioning-guide.md - Semantic versioning examples
- Location:
/Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/skill-library-manager/references/versioning-guide.md
- Location:
- assets/catalog-schema.json - JSON schema for catalog validation
- Location:
/Users/guillaumebld/Documents/Skills/Skills_librairie/Skills/skill-library-manager/assets/catalog-schema.json
- Location:
Related Skills in This Repository
- Meta-skill/skill-creator - Foundation for creating skills (based on Anthropic's skill-creator)
- Infrastructure-DevOps/vps-deployment-stack - Example of well-structured skill with references
- Infrastructure-DevOps/docker-development-workflow - Example with multiple reference files and assets
- Automation/n8n-workflow-patterns - Example of comprehensive skill documentation
- Meta-skill/skill-quality-auditor - Quality assurance for skills
Repository-Specific Notes
- Repository Path:
/Users/guillaumebld/Documents/Skills/Skills_librairie - GitHub Remote:
https://github.com/GuillaumeBld/Skills_librairie.git - Skill Organization: Skills are organized by category in
Skills/directory - Categories: Meta-skill, Automation, Infrastructure-DevOps, Development, Design-Creative, Communication, Document-Generation, AI-Agents
- Catalog Location:
catalog.jsonat repository root (auto-generated) - Management Scripts: Located in
Skills/skill-library-manager/scripts/
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?