rust-skill-creator

name	rust-skill-creator
description	Use when creating skills for Rust crates or std library documentation. Keywords: create rust skill, create crate skill, create std skill, 创建 rust skill, 创建 crate skill, 创建 std skill, 动态 rust skill, 动态 crate skill, skill for tokio, skill for serde, skill for axum, generate rust skill, rust 技能, crate 技能, 从文档创建skill, from docs create skill
argument-hint	<crate_name|std::module>
context	fork
agent	general-purpose

Rust Skill Creator

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

Create dynamic skills for Rust crates and std library documentation.

When to Use

This skill handles requests to create skills for:

• Third-party crates (tokio, serde, axum, etc.)
• Rust standard library (std::sync, std::marker, etc.)
• Any Rust documentation URL

Execution Mode Detection

CRITICAL: Check if related commands/skills are available.

This skill relies on:

• /create-llms-for-skills command
• /create-skills-via-llms command

---

Agent Mode (Plugin Install)

When the commands above are available (full plugin installation):

Workflow

1. Identify the Target

User Request	Target Type	URL Pattern
"create tokio skill"	Third-party crate	docs.rs/tokio/latest/tokio/
"create Send trait skill"	Std library	doc.rust-lang.org/std/marker/trait.Send.html
"create skill from URL" + URL	Custom URL	User-provided URL

2. Execute the Command

Use the /create-llms-for-skills command:

/create-llms-for-skills <url> [requirements]

Examples:

# For third-party crate
/create-llms-for-skills https://docs.rs/tokio/latest/tokio/

# For std library
/create-llms-for-skills https://doc.rust-lang.org/std/marker/trait.Send.html

# With specific requirements
/create-llms-for-skills https://docs.rs/axum/latest/axum/ "Focus on routing and extractors"

3. Follow-up with Skill Creation

After llms.txt is generated, use:

/create-skills-via-llms <crate_name> <llms_path> [version]

---

Inline Mode (Skills-only Install)

When the commands above are NOT available, create skills manually:

Step 1: Identify Target and Construct URL

Target	URL Template
Crate overview	https://docs.rs/{crate}/latest/{crate}/
Crate module	https://docs.rs/{crate}/latest/{crate}/{module}/
Std trait	https://doc.rust-lang.org/std/{module}/trait.{Name}.html
Std struct	https://doc.rust-lang.org/std/{module}/struct.{Name}.html
Std module	https://doc.rust-lang.org/std/{module}/index.html

Step 2: Fetch Documentation

# Using agent-browser CLI
agent-browser open "<documentation_url>"
agent-browser get text ".docblock"
agent-browser close

Or with WebFetch fallback:

WebFetch("<documentation_url>", "Extract API documentation including types, functions, and examples")

Step 3: Create Skill Directory

mkdir -p ~/.Codex/skills/{crate_name}
mkdir -p ~/.Codex/skills/{crate_name}/references

Step 4: Generate SKILL.md

Create ~/.Codex/skills/{crate_name}/SKILL.md with this template:

---
name: {crate_name}
description: "Documentation for {crate_name} crate. Keywords: {keywords}"
---

# {Crate Name}

> **Version:** {version} | **Source:** docs.rs

## Overview

{Brief description from documentation}

## Key Types

### {Type1}
{Description and usage}

### {Type2}
{Description and usage}

## Common Patterns

{Usage patterns extracted from documentation}

## Examples

```rust
{Example code from documentation}

Documentation

• ./references/overview.md - Main overview
• ./references/{module}.md - Module documentation

Links

• docs.rs
• crates.io

### Step 5: Generate Reference Files

For each major module or type, create a reference file:

```bash
# Fetch and save module documentation
agent-browser open "https://docs.rs/{crate}/latest/{crate}/{module}/"
agent-browser get text ".docblock" > ~/.Codex/skills/{crate_name}/references/{module}.md
agent-browser close

Step 6: Verify Skill

# Check skill structure
ls -la ~/.Codex/skills/{crate_name}/
cat ~/.Codex/skills/{crate_name}/SKILL.md

---

URL Construction Helper

Target	URL Template
Crate overview	https://docs.rs/{crate}/latest/{crate}/
Crate module	https://docs.rs/{crate}/latest/{crate}/{module}/
Std trait	https://doc.rust-lang.org/std/{module}/trait.{Name}.html
Std struct	https://doc.rust-lang.org/std/{module}/struct.{Name}.html
Std module	https://doc.rust-lang.org/std/{module}/index.html

Common Std Library Paths

Item	Path
Send, Sync, Copy, Clone	std/marker/trait.{Name}.html
Arc, Mutex, RwLock	std/sync/struct.{Name}.html
Rc, Weak	std/rc/struct.{Name}.html
RefCell, Cell	std/cell/struct.{Name}.html
Box	std/boxed/struct.Box.html
Vec	std/vec/struct.Vec.html
String	std/string/struct.String.html
Option	std/option/enum.Option.html
Result	std/result/enum.Result.html

---

Example Interactions

Example 1: Create Crate Skill (Agent Mode)

User: "Create a dynamic skill for tokio"

Codex:
1. Identify: Third-party crate "tokio"
2. Execute: /create-llms-for-skills https://docs.rs/tokio/latest/tokio/
3. Wait for llms.txt generation
4. Execute: /create-skills-via-llms tokio ~/tmp/{timestamp}-tokio-llms.txt

Example 2: Create Crate Skill (Inline Mode)

User: "Create a dynamic skill for tokio"

Codex:
1. Identify: Third-party crate "tokio"
2. Fetch: agent-browser open "https://docs.rs/tokio/latest/tokio/"
3. Extract documentation
4. Create: ~/.Codex/skills/tokio/SKILL.md
5. Create: ~/.Codex/skills/tokio/references/
6. Save reference files for key modules (sync, task, runtime, etc.)

Example 3: Create Std Library Skill

User: "Create a skill for Send and Sync traits"

Codex:
1. Identify: Std library traits
2. (Agent Mode) Execute: /create-llms-for-skills https://doc.rust-lang.org/std/marker/trait.Send.html https://doc.rust-lang.org/std/marker/trait.Sync.html
   (Inline Mode) Fetch each URL, create skill manually
3. Complete skill creation

---

DO NOT

• Use best-skill-creator for Rust-related skill creation
• Guess documentation URLs without verification
• Skip documentation fetching step

Output Location

All generated skills are saved to: ~/.Codex/skills/

Error Handling

Error	Cause	Solution
Commands not found	Skills-only install	Use inline mode
URL not found	Invalid crate/module	Verify crate exists on crates.io
Empty documentation	API changed	Use alternative selectors
Permission denied	Directory issue	Check ~/.Codex/skills/ permissions