Agenticx Skill Manager

AgenticX Skill Manager

Guide for managing the AgenticX skill ecosystem.

What Are Skills?

Skills are self-contained instruction bundles (SKILL.md + optional resources) that teach AI agents how to perform specific tasks. AgenticX is compatible with the Anthropic Agent Skills specification.

Skill Discovery Paths

The skill loader scans these directories (highest priority first):

CLI Commands

List Skills

bashCopy code
# List all locally discovered skills
agx skills list

# Include remote registry skills
agx skills list --remote

# Output as JSON
agx skills list --format json

Search Skills

bashCopy code
# Search by keyword
agx skills search "pdf"
agx skills search "workflow"

# Search in remote registry
agx skills search "data analysis" --remote

Install a Skill

bashCopy code
# Install from registry
agx skills install pdf-processor

# Install to specific path
agx skills install pdf-processor --path ./.agents/skills

Uninstall a Skill

bashCopy code
agx skills uninstall pdf-processor

Publish a Skill

bashCopy code
# Publish to default registry
agx skills publish ./my-skills/data-analyzer

# Publish to a specific registry URL
agx skills publish ./my-skills/data-analyzer --registry http://registry.example.com:8321

Run a Skill Registry Server

bashCopy code
# Start local registry (default port 8321)
agx skills serve

# Custom port
agx skills serve --port 9000

Creating a Skill

Skill Structure

Copy code
my-skill/
├── SKILL.md          # Required: frontmatter + instructions
├── scripts/          # Optional: executable code
├── references/       # Optional: additional documentation
└── assets/           # Optional: templates, images, data

SKILL.md Format

markdownCopy code
---
name: my-skill
description: What this skill does and when to use it. Be specific about triggers.
metadata:
  author: your-name
  version: "1.0"
---

# My Skill

Instructions for the AI agent to follow when this skill is activated.

## Steps
1. First step
2. Second step

## Examples
- Example usage pattern

Key Rules

• name: lowercase, hyphens only, max 64 chars, must match directory name
• description: max 1024 chars, include both what it does AND when to trigger
• Body: under 500 lines; split large content into references/ files

Programmatic Access

SkillBundleLoader

pythonCopy code
from agenticx.tools.skill_bundle import SkillBundleLoader

loader = SkillBundleLoader()
skills = loader.scan()

for skill in skills:
    print(f"{skill.name}: {skill.description}")

# Get specific skill
meta = loader.get_skill("agenticx-quickstart")
content = loader.get_skill_content("agenticx-quickstart")

SkillRegistryClient

pythonCopy code
from agenticx.skills import SkillRegistryClient

client = SkillRegistryClient(base_url="http://localhost:8321")
results = client.search("pdf")
client.install("pdf-processor")

Skill Gating

Skills can declare environment requirements in frontmatter:

yamlCopy code
metadata:
  agenticx:
    gate:
      os: ["linux", "darwin"]
      requires_bins: ["ffmpeg"]
      requires_env: ["API_KEY"]

Skills that fail gating are silently skipped during scan.

Skill Sync

Sync skills between directories:

pythonCopy code
from agenticx.tools.skill_sync import sync_skills, check_skills_sync

# Check sync status
status = check_skills_sync()

# Sync .agents/skills → .claude/skills
sync_skills()