Skip to content

AgentSkillOS/SkillAnything

Repository files navigation

SkillAnything
Python License Claude Code OpenClaw Codex

SkillAnything

Making ANY Software Skill-Native
The meta-skill that generates production-ready Skills for AI agent platforms.

Quick StartPipelinePlatformsArchitectureExamplesAttribution


What is SkillAnything?

One target in, production-ready Skills out.

SkillAnything is a Skill that generates Skills. Give it any target -- a CLI tool, REST API, Python library, workflow, or web service -- and it runs a fully automated 7-phase pipeline:

Target: "jq"
  |
  v
[Analyze] -> [Design] -> [Implement] -> [Test] -> [Benchmark] -> [Optimize] -> [Package]
  |                                                                                  |
  v                                                                                  v
analysis.json                                                          dist/
                                                                        ├── claude-code/
                                                                        ├── openclaw/
                                                                        ├── codex/
                                                                        └── generic/

No manual prompt engineering. No copy-paste between platforms. Just tell it what you want a skill for.

Quick Start

Install

# Claude Code
git clone https://github.com/AgentSkillOS/SkillAnything.git ~/.claude/skills/skill-anything

# OpenClaw
git clone https://github.com/AgentSkillOS/SkillAnything.git ~/.openclaw/skills/skill-anything

# Codex
git clone https://github.com/AgentSkillOS/SkillAnything.git ~/.codex/skills/skill-anything

Use

In Claude Code, just say:

> Create a skill for the httpie CLI tool
> Generate a multi-platform skill for the Stripe API
> Turn this data pipeline workflow into a skill

SkillAnything handles the rest.

Run Individual Phases

# Phase 1: Analyze a target
python -m scripts.analyze_target --target "jq" --output analysis.json

# Phase 2: Design architecture
python -m scripts.design_skill --analysis analysis.json --output architecture.json

# Phase 3: Scaffold skill
python -m scripts.init_skill my-skill --template cli --output ./out

# Phase 4: Generate test cases
python -m scripts.generate_tests --analysis analysis.json --skill-path ./out/my-skill

# Phase 5: Run evaluation
python -m scripts.run_eval --eval-set evals.json --skill-path ./out/my-skill

# Phase 6: Optimize description
python -m scripts.run_loop --eval-set trigger-evals.json --skill-path ./out/my-skill --model claude-sonnet-4-20250514

# Phase 7: Package for all platforms
python -m scripts.package_multiplatform ./out/my-skill --platforms claude-code,openclaw,codex

The 7-Phase Pipeline

Inspired by CLI-Anything's methodology, adapted for Skill generation:

Phase Name What It Does Output
1 Analyze Auto-detect target type, extract capabilities analysis.json
2 Design Map capabilities to skill architecture architecture.json
3 Implement Generate SKILL.md + scripts + references Complete skill directory
4 Test Plan Auto-generate eval cases + trigger queries evals.json
5 Evaluate Benchmark with/without skill, grade results benchmark.json
6 Optimize Improve description via train/test loop Optimized SKILL.md
7 Package Multi-platform distribution packages dist/

Target Auto-Detection

Target Type Detection Method Example
CLI Tool which <name> + --help parsing jq, httpie, ffmpeg
REST API URL with OpenAPI/Swagger spec Stripe API, GitHub API
Library Package name via pip/npm pandas, lodash
Workflow Step-by-step description ETL pipeline, CI/CD flow
Service URL with web docs Slack, Notion

Supported Platforms

Claude Code
~/.claude/skills/
OpenClaw
~/.openclaw/skills/
OpenAI Codex
~/.codex/skills/
Generic
.skill zip
Full support
Hooks in frontmatter
Full support
External settings.json
Full support
openai.yaml companion
Full support
Platform-agnostic

Architecture

SkillAnything/
├── SKILL.md                    # Main entry point (< 500 lines)
├── METHODOLOGY.md              # Full 7-phase pipeline spec
├── config.yaml                 # Pipeline configuration
│
├── agents/                     # Subagent instructions
│   ├── analyzer.md             # Phase 1: Target analysis
│   ├── designer.md             # Phase 2: Skill design
│   ├── implementer.md          # Phase 3: Content writing
│   ├── grader.md               # Phase 5: Eval grading
│   ├── comparator.md           # Blind A/B comparison
│   ├── optimizer.md            # Phase 6: Description optimization
│   └── packager.md             # Phase 7: Multi-platform packaging
│
├── scripts/                    # Python automation core
│   ├── analyze_target.py       # [NEW] Target auto-detection
│   ├── design_skill.py         # [NEW] Architecture generation
│   ├── init_skill.py           # [NEW] Skill scaffolding
│   ├── generate_tests.py       # [NEW] Auto test generation
│   ├── package_multiplatform.py # [NEW] Multi-platform packaging
│   ├── obfuscate.py            # [NEW] PyArmor wrapper
│   ├── run_eval.py             # Trigger evaluation
│   ├── improve_description.py  # AI-powered optimization
│   ├── run_loop.py             # Eval + improve loop
│   ├── aggregate_benchmark.py  # Benchmark statistics
│   └── ...                     # + validators, reporters
│
├── references/                 # Documentation
│   ├── platform-formats.md     # Platform-specific specs
│   ├── schemas.md              # JSON schemas
│   └── pipeline-phases.md      # Phase details
│
├── templates/                  # Generation templates
│   ├── skill-scaffold/         # Skill directory template
│   └── platform-adapters/      # Platform-specific adapters
│
└── eval-viewer/                # Interactive eval review UI
    └── generate_review.py

Examples

Example 1: CLI Tool Skill

> Create a skill for the jq CLI tool

Phase 1: Analyzing jq... detected as CLI tool (confidence: 0.95)
Phase 2: Designing skill architecture... tool-augmentation pattern
Phase 3: Generating SKILL.md + 2 scripts + 1 reference
Phase 4: Created 5 test cases + 20 trigger queries
Phase 5: Benchmark: 87% pass rate (vs 42% baseline)
Phase 6: Description optimized: 18/20 trigger accuracy
Phase 7: Packaged for claude-code, openclaw, codex, generic

Done! Skill at: sa-workspace/dist/

Example 2: API Skill

> Generate a skill for the Stripe API, focus on payments

Phase 1: Fetching Stripe OpenAPI spec... 247 endpoints found
Phase 2: Focusing on payment_intents, customers, charges
Phase 3: Generated SKILL.md with auth setup + endpoint references
...

Example 3: Workflow Skill

> Turn this into a skill: fetch from Postgres, clean with pandas, upload to S3

Phase 1: Detected workflow with 3 steps
Phase 2: workflow-orchestrator pattern, 3 dependencies
Phase 3: Step-by-step SKILL.md with error handling guidance
...

Configuration

Edit config.yaml:

pipeline:
  auto_mode: true              # Full automation or interactive
  skip_eval: false             # Skip phases 5-6 for rapid prototyping

platforms:
  enabled: [claude-code, openclaw, codex, generic]
  primary: claude-code

eval:
  max_optimization_iterations: 5
  runs_per_query: 3

obfuscation:
  enabled: false               # PyArmor protection for core scripts

Code Protection

SkillAnything supports code obfuscation for commercial distribution:

# Obfuscate original scripts (Apache 2.0 derived files are excluded)
python -m scripts.obfuscate --config config.yaml

# Output: dist-protected/ with PyArmor-protected core + readable adapted scripts
Category Files Protection
SkillAnything Original 6 scripts PyArmor obfuscated
Anthropic Adapted 9 scripts Source (Apache 2.0 requires it)
Agent Instructions 7 .md files Readable (required by agents)

Attribution

Built on the shoulders of giants:

Project License What We Used
CLI-Anything MIT 7-phase pipeline methodology
Dazhuang Skill Creator Apache 2.0 Project structure pattern
Anthropic Skill Creator Apache 2.0 Eval/benchmark system, agent instructions

See NOTICE for complete attribution details.

Contributing

We welcome contributions! Areas where help is needed:

  • New target type analyzers (e.g., GraphQL, gRPC)
  • Platform adapters for additional agent frameworks
  • Evaluation improvements and test case quality
  • Documentation and examples

License

MIT License -- see LICENSE for details.


SkillAnything -- Making ANY Software Skill-Native
If CLI-Anything makes CLIs for software, SkillAnything makes Skills for everything.

About

Making ANY Software Skill-Native -- Auto-generate production-ready AI Agent Skills for Claude Code, OpenClaw, Codex, and more.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors