skilldo

Category: Development & Coding | Uploader: SkillDoAI | Downloads: 0 | Version: v1.0（Latest）

Generate SKILL.md agent rules files for software libraries. Use when you need to create, review, or lint SKILL.md documentation for Python, Go, JavaScript, or Rust libraries, or when configuring skilldo.toml files.

Changelog: Source: GitHub https://github.com/SkillDoAI/skilldo

Directory Structure

Current level: Root

📁 .github/
- 📁 workflows/
  - 📄 auto-tag.yml 869 B
  - 📄 ci.yml 10.4 KB
  - 📄 release.yml 4.9 KB
- 📄 dependabot.yml 465 B
📁 dev/
- 📁 configs/
  - 📁 batch/
    
    📄 claude-sonnet.toml 408 B
    
    📄 gpt41.toml 391 B
- 📁 scripts/
  - 📄 batch-generate.sh 12.2 KB
📁 docs/
- 📄 architecture.md 4.4 KB
- 📄 authentication.md 2.6 KB
- 📄 best-practices.md 6.3 KB
- 📄 configuration.md 7.0 KB
- 📄 languages.md 2.7 KB
- 📄 telemetry.md 2.3 KB
📁 examples/
- 📁 configs/
  - 📄 anthropic.toml 327 B
  - 📄 api-gateway.toml 1.1 KB
  - 📄 deepseek.toml 331 B
  - 📄 github-models.toml 598 B
  - 📄 hybrid.toml 601 B
  - 📄 ollama.toml 494 B
  - 📄 openai.toml 257 B
  - 📄 per-agent-extra-body.toml 1.2 KB
  - 📄 reference.toml 13.2 KB
- 📁 skills/
  - 📁 go/
    
    📄 chi-SKILL.md 13.4 KB
    
    📄 cobra-SKILL.md 13.5 KB
    
    📄 echo-SKILL.md 28.1 KB
    
    📄 fiber-SKILL.md 12.2 KB
    
    📄 gin-SKILL.md 16.8 KB
    
    📄 logrus-SKILL.md 10.7 KB
    
    📄 testify-SKILL.md 11.6 KB
    
    📄 viper-SKILL.md 16.4 KB
    
    📄 zap-SKILL.md 11.8 KB
  - 📁 python/
    
    📄 aiohttp-SKILL.md 25.8 KB
    
    📄 arrow-SKILL.md 16.1 KB
    
    📄 beautifulsoup4-SKILL.md 21.6 KB
    
    📄 boto3-SKILL.md 16.0 KB
    
    📄 celery-SKILL.md 13.0 KB
    
    📄 click-SKILL.md 8.7 KB
    
    📄 cryptography-SKILL.md 15.8 KB
    
    📄 django-SKILL.md 20.2 KB
    
    📄 fastapi-SKILL.md 9.8 KB
    
    📄 flask-SKILL.md 23.2 KB
    
    📄 httpx-SKILL.md 21.9 KB
    
    📄 jinja2-SKILL.md 9.9 KB
    
    📄 keras-SKILL.md 26.3 KB
    
    📄 matplotlib-SKILL.md 15.9 KB
    
    📄 numpy-SKILL.md 13.5 KB
    
    📄 pandas-SKILL.md 22.3 KB
    
    📄 pillow-SKILL.md 8.2 KB
    
    📄 pydantic-SKILL.md 14.3 KB
    
    📄 pytest-SKILL.md 7.5 KB
    
    📄 pytorch-SKILL.md 22.7 KB
    
    📄 requests-SKILL.md 15.5 KB
    
    📄 rich-SKILL.md 23.3 KB
    
    📄 scikit-learn-SKILL.md 21.5 KB
    
    📄 scipy-SKILL.md 24.0 KB
    
    📄 sqlalchemy-SKILL.md 28.9 KB
    
    📄 transformers-SKILL.md 23.1 KB
    
    📄 typer-SKILL.md 29.7 KB
    
    📄 unstructured-SKILL.md 29.3 KB
  - 📄 README.md 911 B
📁 rules/
- 📁 cisco/
  - 📄 ATTRIBUTION.md 3.5 KB
  - 📄 autonomy_abuse_generic.yara 3.2 KB
  - 📄 capability_inflation_generic.yara 3.1 KB
  - 📄 code_execution_generic.yara 3.1 KB
  - 📄 coercive_injection_generic.yara 4.6 KB
  - 📄 command_injection_generic.yara 3.5 KB
  - 📄 credential_harvesting_generic.yara 7.8 KB
  - 📄 embedded_binary_detection.yara 3.1 KB
  - 📄 HEY_CISCO.txt 880 B
  - 📄 indirect_prompt_injection_generic.yara 2.9 KB
  - 📄 LICENSE 653 B
  - 📄 prompt_injection_generic.yara 5.0 KB
  - 📄 prompt_injection_unicode_steganography.yara 3.0 KB
  - 📄 script_injection_generic.yara 4.5 KB
  - 📄 sql_injection_generic.yara 4.8 KB
  - 📄 system_manipulation_generic.yara 4.4 KB
  - 📄 tool_chaining_abuse_generic.yara 3.7 KB
- 📁 skilldo/
  - 📄 dangerous_patterns.yara 6.8 KB
  - 📄 LICENSE 661 B
  - 📄 prompt_injection.yara 5.7 KB
  - 📄 README.md 3.6 KB
  - 📄 unicode_attacks.yara 3.7 KB
📁 src/
- 📁 auth/
  - 📄 device_code.rs 17.6 KB
  - 📄 mod.rs 23.3 KB
  - 📄 oauth.rs 34.2 KB
  - 📄 pkce.rs 2.7 KB
- 📁 cli/
  - 📄 auth.rs 32.7 KB
  - 📄 config_check.rs 53.3 KB
  - 📄 generate.rs 45.5 KB
  - 📄 lint.rs 4.6 KB
  - 📄 mod.rs 123 B
  - 📄 review.rs 25.5 KB
  - 📄 show_prompts.rs 5.6 KB
  - 📄 version.rs 47.2 KB
- 📁 ecosystems/
  - 📄 go.rs 69.5 KB
  - 📄 javascript.rs 46.0 KB
  - 📄 mod.rs 4.9 KB
  - 📄 python.rs 72.5 KB
  - 📄 rust.rs 98.4 KB
- 📁 llm/
  - 📄 agents.rs 135 B
  - 📄 cli_client.rs 13.1 KB
  - 📄 client.rs 15.3 KB
  - 📄 client_impl.rs 36.6 KB
  - 📄 factory.rs 19.6 KB
  - 📄 mod.rs 110 B
  - 📄 prompts_v2.rs 65.4 KB
- 📁 pipeline/
  - 📄 collector.rs 72.6 KB
  - 📄 generator.rs 117.0 KB
  - 📄 mod.rs 58 B
  - 📄 normalizer.rs 42.7 KB
- 📁 review/
  - 📄 mod.rs 20.0 KB
- 📁 security/
  - 📄 injection.rs 10.5 KB
  - 📄 mod.rs 27.0 KB
  - 📄 unicode.rs 7.7 KB
  - 📄 yara.rs 38.5 KB
- 📁 test_agent/
  - 📄 code_generator.rs 7.5 KB
  - 📄 container_executor.rs 46.8 KB
  - 📄 executor.rs 42.5 KB
  - 📄 go_code_gen.rs 12.6 KB
  - 📄 go_parser.rs 18.3 KB
  - 📄 js_code_gen.rs 17.8 KB
  - 📄 js_parser.rs 26.4 KB
  - 📄 mod.rs 4.0 KB
  - 📄 parser.rs 4.1 KB
  - 📄 python_code_gen.rs 16.1 KB
  - 📄 python_parser.rs 24.0 KB
  - 📄 rust_code_gen.rs 12.3 KB
  - 📄 rust_parser.rs 25.1 KB
  - 📄 validator.rs 60.6 KB
- 📄 changelog.rs 14.8 KB
- 📄 config.rs 76.1 KB
- 📄 detector.rs 6.4 KB
- 📄 error.rs 2.0 KB
- 📄 git.rs 21.4 KB
- 📄 lib.rs 628 B
- 📄 lint.rs 85.5 KB
- 📄 main.rs 42.3 KB
- 📄 telemetry.rs 18.7 KB
- 📄 util.rs 21.3 KB
📁 tests/
- 📁 fixtures/
  - 📁 security/
    
    📄 clean-skill.md 1.2 KB
    
    📄 evasive-01-base64-payload.md 681 B
    
    📄 evasive-03-prompt-subtle.md 890 B
    
    📄 evasive-05-alias-chain.md 948 B
    
    📄 evasive-06-unicode-injection.md 685 B
    
    📄 evasive-08-reverse-shell.md 1021 B
    
    📄 evasive-10-roleplay.md 879 B
    
    📄 evasive-12-multi-stage.md 1.2 KB
    
    📄 legit-api-skill.md 2.1 KB
    
    📄 malicious-skill.md 688 B
  - 📄 click-SKILL.md 1.6 KB
  - 📄 fastapi_session.json 9.5 KB
  - 📄 go-fmt-SKILL.md 1.2 KB
  - 📄 pathlib-SKILL.md 1.3 KB
- 📄 changelog_analysis_test.rs 5.6 KB
- 📄 collector_test.rs 7.9 KB
- 📄 config_test.rs 5.5 KB
- 📄 executor_error_test.rs 4.5 KB
- 📄 INTEGRATION_TEST_COVERAGE.md 6.8 KB
- 📄 lint_print_test.rs 3.6 KB
- 📄 lint_test.rs 8.1 KB
- 📄 python_handler_test.rs 4.9 KB
- 📄 test_adversarial_linter.rs 8.7 KB
- 📄 test_agent_integration.rs 24.4 KB
- 📄 test_collector.rs 30.2 KB
- 📄 TEST_COVERAGE_SUMMARY.md 7.8 KB
- 📄 test_ecosystem_integration.rs 11.2 KB
- 📄 test_error_handling.rs 4.5 KB
- 📄 test_file_prioritization.rs 6.7 KB
- 📄 test_fixture_pipeline.rs 18.2 KB
- 📄 test_generator.rs 4.1 KB
- 📄 test_generator_comprehensive.rs 35.6 KB
- 📄 test_integration.rs 17.9 KB
- 📄 test_license_toml_table.rs 1.1 KB
- 📄 test_linter.rs 62.1 KB
- 📄 test_prompts.rs 33.9 KB
- 📄 test_python_handler.rs 1.7 KB
- 📄 test_python_metadata.rs 43.0 KB
- 📄 test_version_override.rs 5.9 KB
📄 .coderabbit.yaml 567 B
📄 .gitignore 580 B
📄 .pre-commit-config.yaml 1.1 KB
📄 about.hbs 1.8 KB
📄 about.toml 375 B
📄 Cargo.lock 76.0 KB
📄 Cargo.toml 807 B
📄 CHANGELOG.md 15.6 KB
📄 cliff.toml 2.2 KB
📄 codecov.yml 114 B
📄 LICENSE 34.4 KB
📄 Makefile 7.7 KB
📄 MIGRATION.md 4.5 KB
📄 README.md 6.1 KB
📄 SKILL.md 5.4 KB
📄 THIRD-PARTY-LICENSES.html 479.7 KB

SKILL.md

---
name: skilldo
description: Generate SKILL.md agent rules files for software libraries. Use when you need to create, review, or lint SKILL.md documentation for Python, Go, JavaScript, or Rust libraries, or when configuring skilldo.toml files.
license: AGPL-3.0
compatibility: Requires an LLM API key (Anthropic, OpenAI, Gemini, or OpenAI-compatible). Optional container runtime (docker/podman) for test validation.
metadata:
  author: SkillDoAI
  version: "0.4.2"
---

# Skilldo CLI

Skilldo is a 6-stage LLM pipeline that generates SKILL.md files for software libraries:
**extract** → **map** → **learn** → **create** → **review** → **test**

Stages 1-3 gather library metadata (source files, docs, dependencies, version).
Stage 4 generates the SKILL.md. Stage 5 reviews for accuracy/safety. Stage 6 validates
with generated test code.

## Installation

```bash
# Homebrew
brew install skilldoai/tap/skilldo

# From source
cargo install --path .
```

## Quick Start

```bash
# Generate a SKILL.md for the current repo
skilldo generate

# Generate for a specific repo path
skilldo generate /path/to/library

# Specify language explicitly
skilldo generate --language python

# Use a specific config
skilldo generate --config skilldo.toml
```

## Configuration (skilldo.toml)

Skilldo uses TOML config files. Place `skilldo.toml` in the repo root, or pass `--config`.

### Minimal config (single provider)

```toml
[llm]
provider_type = "anthropic"          # anthropic, openai, gemini, openai-compatible, chatgpt
model = "claude-sonnet-4-6"
api_key_env = "ANTHROPIC_API_KEY"  # env var name containing the key

[generation]
max_retries = 5                 # retry on lint/test failures
# telemetry = true              # opt-in: log runs to ~/.skilldo/runs.csv
```

### Per-stage model overrides

Different models can be used for review and test stages:

```toml
[llm]
provider_type = "anthropic"
model = "claude-sonnet-4-6"
api_key_env = "ANTHROPIC_API_KEY"

[generation]
enable_test = true
enable_review = true
test_mode = "thorough"          # thorough, adaptive, minimal

[generation.review_llm]
provider_type = "openai"
model = "gpt-5.2"
api_key_env = "OPENAI_API_KEY"

[generation.test_llm]
provider_type = "openai"
model = "gpt-5.2"
api_key_env = "OPENAI_API_KEY"
```

### Local models (Ollama)

```toml
[llm]
provider_type = "openai-compatible"
model = "qwen3-coder:latest"
base_url = "http://localhost:11434/v1"
api_key_env = "none"            # Ollama doesn't need a key
```

### Container settings (optional)

```toml
[generation.container]
runtime = "podman"              # docker or podman
timeout = 120                   # seconds
cleanup = true
```

## Commands

### `skilldo generate [PATH]`
Generate a SKILL.md for a library repository.

Key flags:
- `--language <LANG>` — force language (python, javascript, rust, go)
- `--config <PATH>` — config file path
- `--model <MODEL>` — override LLM model
- `--no-test` — skip test validation
- `--no-review` — skip review validation
- `--no-security-scan` — skip YARA/unicode/injection scanning
- `--best-effort` — exit 0 even with errors
- `--telemetry` / `--no-telemetry` — toggle run logging
- `--container` — run test agent in container (default: bare-metal)
- `-o <PATH>` — output file (default: SKILL.md)

### `skilldo lint <PATH>`
Lint a SKILL.md for structural errors (frontmatter, sections, code blocks).

### `skilldo review <PATH>`
LLM-powered review of an existing SKILL.md for accuracy and safety.

Key flags:
- `--config <PATH>` — config with LLM settings

### `skilldo config check --config <PATH>`
Validate a config file for correctness.

### `skilldo auth login|status|logout`
Manage OAuth tokens for providers that use OAuth (e.g., ChatGPT).

## Supported Languages

| Language | Ecosystem | Detection |
|----------|-----------|-----------|
| Python | pip/uv, pyproject.toml, setup.py | `*.py`, `pyproject.toml` |
| JavaScript/TypeScript | npm, package.json | `*.js`, `*.ts`, `package.json` |
| Go | go modules, go.mod | `*.go`, `go.mod` |
| Rust | cargo, Cargo.toml | `*.rs`, `Cargo.toml` |

## Common Workflows

### Generate with Anthropic
```bash
source ~/.anthropic
skilldo generate --provider anthropic --model claude-sonnet-4-6
```

### Generate with OpenAI
```bash
source ~/.openai
skilldo generate --provider openai --model gpt-5.2
```

### Generate with local Ollama
```bash
skilldo generate --provider openai-compatible --model qwen3-coder:latest --base-url http://localhost:11434/v1
```

### Batch generation (multiple repos)
```bash
for repo in /path/to/repos/*/; do
  skilldo generate "$repo" --config shared-config.toml --best-effort
done
```

### Review an existing SKILL.md
```bash
skilldo review SKILL.md --config skilldo.toml
```

## Telemetry

When `telemetry = true`, each run appends a row to `~/.skilldo/runs.csv`:
- Timestamp, language, library name, version
- Models and providers used (generate, review, test)
- Pass/fail, retry count, duration, failure details

Data is local only — nothing is sent anywhere.

## Troubleshooting

- **"No tests found"** — language detection may have failed. Use `--language` explicitly.
- **Test failures looping** — try `--test-mode minimal` or `--no-test` for a first pass.
- **Rate limited** — increase `retry_delay` in config, or switch to a local model.
- **OAuth errors** — run `skilldo auth status --config <path>` to check token state.
- **install_source errors on non-Python** — `local-install`/`local-mount` only works for Python. Use default `registry` for other languages.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

skilldo

Directory Structure

SKILL.md

Report

Notice