core-dynamic-skills

name	core-dynamic-skills
description	Internal command support for dynamic Rust crate skill management. Use only when explicitly invoked by /sync-crate-skills, /clean-crate-skills, or /update-crate-skill.
disable-model-invocation	true
argument-hint	[--force] | <crate_name>
context	fork
agent	general-purpose

Dynamic Skills Manager

Version: 2.1.0 | Last Updated: 2025-01-27

Orchestrates on-demand generation of crate-specific skills based on project dependencies.

Concept

Dynamic skills are:

• Generated locally at ~/.Codex/skills/
• Based on Cargo.toml dependencies
• Created using llms.txt from docs.rs
• Versioned and updatable
• Not committed to the rust-skills repository

Trigger Scenarios

Prompt-on-Open

When entering a directory with Cargo.toml:

1. Detect Cargo.toml (single or workspace)
2. Parse dependencies list
3. Check which crates are missing skills
4. If missing: "Found X dependencies without skills. Sync now?"
5. If confirmed: run /sync-crate-skills

Manual Commands

• /sync-crate-skills - Sync all dependencies
• /clean-crate-skills [crate] - Remove skills
• /update-crate-skill <crate> - Update specific skill

Execution Mode Detection

CRITICAL: Check if agent and command infrastructure is available.

Try to read: ../../agents/ directory Check if /create-llms-for-skills and /create-skills-via-llms commands work.

---

Agent Mode (Plugin Install)

When full plugin infrastructure is available:

Architecture

Cargo.toml
    ↓
Parse dependencies
    ↓
For each crate:
  ├─ Check ~/.Codex/skills/{crate}/
  ├─ If missing: Check actionbook for llms.txt
  │     ├─ Found: /create-skills-via-llms
  │     └─ Not found: /create-llms-for-skills first
  └─ Load skill

Workflow Priority

1. actionbook MCP - Check for pre-generated llms.txt
2. /create-llms-for-skills - Generate llms.txt from docs.rs
3. /create-skills-via-llms - Create skills from llms.txt

Sync Command

/sync-crate-skills [--force]

1. Parse Cargo.toml for dependencies
2. For each dependency:
   • Check if skill exists at ~/.Codex/skills/{crate}/
   • If missing (or --force): generate skill
3. Report results

---

Inline Mode (Skills-only Install)

When agent/command infrastructure is NOT available, execute manually:

Step 1: Parse Cargo.toml

# Read dependencies
cat Cargo.toml | grep -A 100 '\[dependencies\]' | grep -E '^[a-zA-Z]'

Or use Read tool to parse Cargo.toml and extract:

• [dependencies] section
• [dev-dependencies] section (optional)
• Workspace members (if workspace project)

Step 2: Check Existing Skills

# List existing skills
ls ~/.Codex/skills/

Compare with dependencies to find missing skills.

Step 3: Generate Missing Skills

For each missing crate:

# 1. Fetch crate documentation
agent-browser open "https://docs.rs/{crate}/latest/{crate}/"
agent-browser get text ".docblock"
# Save content

# 2. Create skill directory
mkdir -p ~/.Codex/skills/{crate}
mkdir -p ~/.Codex/skills/{crate}/references

# 3. Create SKILL.md
# Use template from rust-skill-creator inline mode

# 4. Create reference files for key modules
agent-browser open "https://docs.rs/{crate}/latest/{crate}/{module}/"
agent-browser get text ".docblock"
# Save to ~/.Codex/skills/{crate}/references/{module}.md

agent-browser close

WebFetch fallback:

WebFetch("https://docs.rs/{crate}/latest/{crate}/", "Extract API documentation overview, key types, and usage examples")

Step 4: Workspace Support

For Cargo workspace projects:

# 1. Parse root Cargo.toml for workspace members
cat Cargo.toml | grep -A 10 '\[workspace\]'

# 2. For each member, parse their Cargo.toml
for member in members; do
  cat ${member}/Cargo.toml | grep -A 100 '\[dependencies\]'
done

# 3. Aggregate and deduplicate dependencies
# 4. Generate skills for missing crates

Clean Command (Inline)

# Clean specific crate
rm -rf ~/.Codex/skills/{crate_name}

# Clean all generated skills
rm -rf ~/.Codex/skills/*

Update Command (Inline)

# Remove old skill
rm -rf ~/.Codex/skills/{crate_name}

# Re-generate (same as sync for single crate)
# Follow Step 3 above for the specific crate

---

Local Skills Directory

~/.Codex/skills/
├── tokio/
│   ├── SKILL.md
│   └── references/
├── serde/
│   ├── SKILL.md
│   └── references/
└── axum/
    ├── SKILL.md
    └── references/

---

Related Commands

• /sync-crate-skills - Main sync command
• /clean-crate-skills - Cleanup command
• /update-crate-skill - Update command
• /create-llms-for-skills - Generate llms.txt (Agent Mode only)
• /create-skills-via-llms - Create skills from llms.txt (Agent Mode only)

Error Handling

Error	Cause	Solution
Commands not found	Skills-only install	Use inline mode
Cargo.toml not found	Not in Rust project	Navigate to project root
docs.rs unavailable	Network issue	Retry or skip crate
Permission denied	Directory issue	Check ~/.Codex/skills/ permissions