Create, Evaluate, and Connect AI Skills
Python ai-agentsai-skillsartificial-intelligenceknowledge-graphlarge-language-modelsnatural-language-processingopenkgskillnetskills
docs: professionalize README
Icarus-Chen55b4b864ca85
diff --git a/README.md b/README.mdindex b68f7de..b9611a8 100644--- a/README.md+++ b/README.md@@ -3,11 +3,13 @@<img src="images/skillnet.png" width="200" alt="SkillNet Logo"></a>-<p><strong>Open Infrastructure for Creating, Evaluating, and Connecting AI Agent Skills</strong></p>+# SkillNet: The Operating System for AI Skills++<p><strong>Search, install, evaluate, and connect reusable AI skills.</strong></p><p>-Search 500,000+ community skills · One-line install · Auto-create from repos / docs / logs<br/>-5-dimension quality scoring · Semantic relationship graph+SkillNet treats AI agent skills as first-class software assets.<br/>+It provides a public skill library, Python SDK, CLI, quality evaluation, and a skill graph.</p>[](https://pypi.org/project/skillnet-ai/)@@ -15,165 +17,188 @@ Search 500,000+ community skills · One-line install · Auto-create from repos /[](https://www.python.org/downloads/)[](https://arxiv.org/abs/2603.04448)[](https://huggingface.co/blog/xzwnlp/skillnet)-[](http://skillnet.openkg.cn/)--<!-- <p align="center">- <a href="#-quick-start">Installation</a> •- <a href="#-python-sdk">Python SDK</a> •- <a href="#-cli-reference">CLI</a> •- <a href="https://arxiv.org/abs/2603.04448">Paper</a> •- <a href="http://skillnet.openkg.cn/">Website</a> •- <a href="https://huggingface.co/blog/xzwnlp/skillnet">HuggingFace</a> •- <a href="#-contributing">Contributing</a> •- <a href="https://x.com/_akhaliq/status/2030024322308342160" target="_blank">Featured By AK</a>-</p> -->+[](http://skillnet.openkg.cn/)-</div>+<p>+ <a href="#get-started">Get started</a> ·+ <a href="#skillnet-explorer">Explorer</a> ·+ <a href="#python-sdk">Python SDK</a> ·+ <a href="#cli-reference">CLI</a> ·+ <a href="#rest-api">REST API</a> ·+ <a href="#citation">Citation</a>+</p>-<h5 align="center"> ⭐ If you like our project, please give us a star on GitHub for the latest updates!</h5>+</div>----**SkillNet** is an open-source platform that treats AI agent skills as first-class, shareable packages — like npm for AI capabilities. It provides end-to-end tooling to **search**, **install**, **create**, **evaluate**, and **organize** skills, so agents can learn from the community and continuously grow.--- We conducted experiments on ALFWorld, WebShop, and ScienceWorld. Reproduction scripts are provided [here](https://github.com/zjunlp/SkillNet/tree/main/experiments).-+## What is SkillNet?+SkillNet is open infrastructure for building and reusing AI agent skills. A skill can package instructions, metadata, references, scripts, and evaluation results so that an agent can install it, inspect it, and use it again later.-## 📢 News-- **🤖 [2026-03-26] JiuwenClaw × SkillNet Integrated!** — [JiuwenClaw](https://github.com/openJiuwen-ai/jiuwenclaw) now natively integrates SkillNet as its built-in skill marketplace. One-click search and install curated skills. [View Guide →](./examples/JiuwenClaw/README.md)+Use SkillNet when you want to:-- **🔌 [2026-03-12] SkillNet MCP Server Released!** — We've launched the Model Context Protocol (MCP) integration (maintained by [CycleChain](https://github.com/CycleChain), special thanks for this great contribution!). [Learn more →](#-model-context-protocol-mcp-integration)+- Find existing skills before an agent rebuilds the same capability.+- Install skills from public GitHub repositories into a local agent workspace.+- Create new skills from repositories, office documents, prompts, or execution traces.+- Evaluate skills across five quality dimensions.+- Build a local graph that shows how skills relate to each other.-- **📄 [2026-03-04] SkillNet Technical Report Released!** — We've published the comprehensive SkillNet Technical Report, covering the system architecture, automated creation pipeline, multi-dimensional evaluation methodology, and the released open-source toolkits. [View Report →](https://arxiv.org/abs/2603.04448)+## Get started-- **🦞 [2026-02-23] OpenClaw Integration Released!** — SkillNet is now available as a built-in skill for [OpenClaw](https://github.com/openclaw/openclaw). One command to install, zero config to use. The agent automatically searches, downloads, creates, evaluates, and analyzes skills on your behalf. [Get started →](#-openclaw-integration)+Install the Python package:-## ✨ Key Features+```bash+pip install skillnet-ai+```-| Feature | Description |-| :-------------------------------------- | :---------------------------------------------------------------------------------------------------------------------- |-| 🔍 **Search** | Find skills via keyword match or AI semantic search across 500+ curated skills |-| 📦 **One‑Line Install** | `skillnet download <url>` — grab any skill from GitHub in seconds |-| ✨ **Auto‑Create** | Convert GitHub repos, PDFs/PPTs/Word docs, conversation logs, or text prompts into structured skill packages using LLMs |-| 📊 **5‑D Evaluation** | Score skills on **Safety · Completeness · Executability · Maintainability · Cost‑Awareness** |-| 🕸️ **Skill Graph** | Auto-discover `similar_to` · `belong_to` · `compose_with` · `depend_on` links between skills |+Search and download a skill:----+```python+from skillnet_ai import SkillNetClient-## 📖 Table of Contents+client = SkillNetClient()-- [Quick Start](#-quick-start)-- [REST API](#-rest-api)-- [Python SDK](#-python-sdk)-- [CLI Reference](#-cli-reference)-- [Configuration](#configuration)-- [Example: Scientific Discovery](#-example-scientific-discovery)-- [Use SkillNet in Code Agents](#-use-skillnet-in-code-agents)-- [OpenClaw Integration](#-openclaw-integration)-- [Model Context Protocol (MCP)](#-model-context-protocol-mcp-integration)-- [Contributing](#-contributing)-- [Citation](#-citation)+results = client.search("pdf understanding", limit=5)+print(results[0].skill_name)+print(results[0].skill_url)----+client.download(url=results[0].skill_url, target_dir="./my_skills")+```-## 🚀 Quick Start+Or use the CLI:```bash-pip install skillnet-ai+skillnet search "pdf understanding" --limit 5+skillnet download <skill_url> -d ./my_skills```-Or using `uv`:+`search` and public GitHub downloads do not require credentials. Set `API_KEY` when you use `create`, `evaluate`, or `analyze` with an LLM.-```bash-uv venv-source .venv/bin/activate-uv pip install skillnet-ai-```+## News-```python-from skillnet_ai import SkillNetClient+- **[2026-03-26] JiuwenClaw integration released.** JiuwenClaw now includes SkillNet as a built-in skill marketplace. [View guide](./examples/JiuwenClaw/README.md)+- **[2026-03-12] SkillNet MCP server released.** MCP support is maintained by [CycleChain](https://github.com/CycleChain).+- **[2026-03-04] Technical report released.** Read the SkillNet report on [arXiv](https://arxiv.org/abs/2603.04448).+- **[2026-02-23] OpenClaw integration released.** SkillNet is available as a built-in skill for [OpenClaw](https://github.com/openclaw/openclaw).-client = SkillNetClient() # No API key needed for search & download+## Table of contents-# Search for skills-results = client.search(q="pdf", limit=5)-print(results[0].skill_name, results[0].stars)+- [SkillNet Explorer](#skillnet-explorer)+- [Core capabilities](#core-capabilities)+- [Use SkillNet in Code Agents](#use-skillnet-in-code-agents)+- [Python SDK](#python-sdk)+- [CLI Reference](#cli-reference)+- [Configuration](#configuration)+- [REST API](#rest-api)+- [Examples and experiments](#examples-and-experiments)+- [More integrations](#more-integrations)+- [Roadmap](#roadmap)+- [Contributing](#contributing)+- [Citation](#citation)-# Install a skill-client.download(url=results[0].skill_url, target_dir="./my_skills")-```+---++## SkillNet Explorer++[SkillNet Explorer](http://skillnet.openkg.cn/) is the visual entry point for the public skill library. It is designed for browsing skills the way developers browse packages or model hubs.++Use the Explorer to:-**🌐 SkillNet Web** — Search, download individual skills, and explore curated skill collections through the [SkillNet website](http://skillnet.openkg.cn/).+- Search skills by keyword or semantic meaning.+- Browse quality-ranked skills and curated collections.+- Inspect skill graph visualizations.+- Find the install path for a skill.<div align="center">-https://github.com/user-attachments/assets/9f9d35b0-36fd-4d7d-a072-39afa380b241+</div>-**🤖 OpenClaw + SkillNet** — See SkillNet in action with [OpenClaw](https://github.com/openclaw/openclaw). The agent automatically searches, creates, evaluates, and analyzes skills on your behalf. [Learn more →](#-openclaw-integration)+The website also includes interactive scenarios for web scraping, paper summarization, and experiment planning.<div align="center">-https://github.com/user-attachments/assets/9d49a00c-827d-47a4-8954-0e6b977ca547+https://github.com/user-attachments/assets/9f9d35b0-36fd-4d7d-a072-39afa380b241</div>----## 🌐 REST API+## Core capabilities++| Capability | What it does |+| :--- | :--- |+| Search | Find skills through keyword search or semantic vector search. |+| Install | Download a skill folder from GitHub into a local workspace. |+| Create | Convert repositories, documents, prompts, or trajectories into structured skill packages. |+| Evaluate | Score skills for Safety, Completeness, Executability, Maintainability, and Cost-Awareness. |+| Connect | Infer `similar_to`, `belong_to`, `compose_with`, and `depend_on` relationships between skills. |++SkillNet treats a skill as a software primitive, not just a prompt. The package format keeps the skill portable; the evaluation layer makes quality visible; the graph layer makes skills easier to compose.++---++## Use SkillNet in Code Agents++SkillNet is also packaged as a portable agent skill at [`skills/skillnet/`](https://github.com/zjunlp/SkillNet/tree/main/skills/skillnet). Install this folder into your code agent's local skills directory, then the agent can search, download, create, evaluate, and organize skills during coding tasks.++<div align="center">++https://github.com/user-attachments/assets/ae6020d9-6846-4672-84ce-fa9c8057e92b++</div>++### Claude Code-The SkillNet search API is free, public, and requires no authentication.+Claude Code discovers user skills from `~/.claude/skills/` and project skills from `.claude/skills/`.++Install as a user skill:```bash-# Keyword search-curl "http://api-skillnet.openkg.cn/v1/search?q=pdf&sort_by=stars&limit=5"+git clone https://github.com/zjunlp/SkillNet.git+cd SkillNet-# Semantic search-curl "http://api-skillnet.openkg.cn/v1/search?q=reading%20charts&mode=vector&threshold=0.8"+mkdir -p ~/.claude/skills+cp -R skills/skillnet ~/.claude/skills/skillnet```-<details>-<summary><b>📡 Full Parameter Reference</b></summary>+Or install as a project-local skill:-**Endpoint:** `GET http://api-skillnet.openkg.cn/v1/search`+```bash+mkdir -p .claude/skills+cp -R /path/to/SkillNet/skills/skillnet .claude/skills/skillnet+```-| Parameter | Type | Default | Description |-| :---------- | :----- | :--------- | :------------------------------------------------- |-| `q` | string | _required_ | Search query (keywords or natural language) |-| `mode` | string | `keyword` | `keyword` (fuzzy match) or `vector` (semantic AI) |-| `category` | string | — | Filter: Development, AIGC, Research, Science, etc. |-| `limit` | int | `10` | Results per page (max 50) |-| `page` | int | `1` | Page number _(keyword mode only)_ |-| `min_stars` | int | `0` | Minimum star count _(keyword mode only)_ |-| `sort_by` | string | `stars` | `stars` or `recent` _(keyword mode only)_ |-| `threshold` | float | `0.8` | Similarity threshold 0.0–1.0 _(vector mode only)_ |+Restart Claude Code or start a new session, then try:-**Response:**+```text+Use SkillNet to search for a docker skill and summarize the top result.+```-```json-{- "data": [- {- "skill_name": "pdf-extractor-v1",- "skill_description": "Extracts text and tables from PDF documents.",- "author": "openkg-team",- "stars": 128,- "skill_url": "https://...",- "category": "Productivity"- }- ],- "meta": { "query": "pdf", "mode": "keyword", "total": 1, "limit": 10 },- "success": true-}+### Codex++Codex discovers user skills from `$CODEX_HOME/skills`. If `CODEX_HOME` is not set, use `~/.codex/skills`.++```bash+git clone https://github.com/zjunlp/SkillNet.git+cd SkillNet++CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"+mkdir -p "$CODEX_HOME/skills"+cp -R skills/skillnet "$CODEX_HOME/skills/skillnet"```-</details>+Restart Codex or start a new session, then try:++```text+Use $skillnet to search for a LangGraph skill before planning this task.+```----## 🐍 Python SDK+## Python SDK### Initialize@@ -181,12 +206,14 @@ curl "http://api-skillnet.openkg.cn/v1/search?q=reading%20charts&mode=vector&thrfrom skillnet_ai import SkillNetClientclient = SkillNetClient(- api_key="sk-...", # Required for create / evaluate / analyze- # base_url="...", # Optional: custom LLM endpoint- # github_token="ghp-..." # Optional: for private repos+ api_key="YOUR_API_KEY", # Required for create, evaluate, and analyze+ # base_url="https://api.openai.com/v1",+ # github_token="YOUR_GITHUB_TOKEN")```+Credentials can also be set through environment variables: `API_KEY`, `BASE_URL`, and `GITHUB_TOKEN`.+### Search```python@@ -194,10 +221,15 @@ client = SkillNetClient(results = client.search(q="pdf", limit=10, min_stars=5, sort_by="stars")# Semantic search-results = client.search(q="analyze financial PDF reports", mode="vector", threshold=0.85)+results = client.search(+ q="analyze financial PDF reports",+ mode="vector",+ threshold=0.85,+)if results:- print(f"{results[0].skill_name} ⭐{results[0].stars}")+ print(results[0].skill_name)+ print(results[0].skill_url)```### Install@@ -205,66 +237,73 @@ if results:```pythonlocal_path = client.download(url="https://github.com/anthropics/skills/tree/main/skills/skill-creator",- target_dir="./my_skills"+ target_dir="./my_skills",)+print(local_path)```### Create-Convert diverse sources into structured skill packages with a single call:+`create` requires `API_KEY`.```python-# From conversation logs / execution traces-client.create(trajectory_content="User: rename .jpg to .png\nAgent: Done.", output_dir="./skills")+# From a conversation log or execution trace+client.create(+ trajectory_content="User: rename .jpg to .png\nAgent: Done.",+ output_dir="./skills",+)-# From GitHub repository+# From a GitHub repositoryclient.create(github_url="https://github.com/zjunlp/DeepKE", output_dir="./skills")-# From office documents (PDF / PPT / Word)+# From an office document: PDF, PPT, or Wordclient.create(office_file="./guide.pdf", output_dir="./skills")-# From natural language prompt+# From a natural language promptclient.create(prompt="A skill for web scraping article titles", output_dir="./skills")```### Evaluate-Score any skill across 5 quality dimensions. Accepts local paths or GitHub URLs.+`evaluate` requires `API_KEY`. It accepts local paths and GitHub URLs.```pythonresult = client.evaluate(target="https://github.com/anthropics/skills/tree/main/skills/algorithmic-art")-# Returns: { "safety": {"level": "Good", "reason": "..."}, "completeness": {...}, ... }++print(result["safety"]["level"])+print(result["executability"]["reason"])```-### Analyze Relationships+### Analyze-Map the connections between skills in a local directory — outputs `similar_to`, `belong_to`, `compose_with`, and `depend_on` edges.+`analyze` requires `API_KEY`. It maps relationships between skills in a local directory.```pythonrelationships = client.analyze(skills_dir="./my_skills")for rel in relationships:print(f"{rel['source']} --[{rel['type']}]--> {rel['target']}")-# PDF_Parser --[compose_with]--> Text_Summarizer```+Relationship types: `similar_to`, `belong_to`, `compose_with`, and `depend_on`.+----## 💻 CLI Reference+## CLI Reference-The CLI ships with `pip install skillnet-ai` and offers the same features with rich terminal output.+The CLI ships with `pip install skillnet-ai`.-| Command | Description | Example |-| :--------- | :--------------------- | :--------------------------------------- |-| `search` | Find skills | `skillnet search "pdf" --mode vector` |-| `download` | Install a skill | `skillnet download <url> -d ./skills` |-| `create` | Create from any source | `skillnet create log.txt --model gpt-4o` |-| `evaluate` | Quality report | `skillnet evaluate ./my_skill` |-| `analyze` | Relationship graph | `skillnet analyze ./my_skills` |+| Command | Description | Example |+| :--- | :--- | :--- |+| `search` | Find skills | `skillnet search "pdf" --mode vector` |+| `download` | Install a skill | `skillnet download <url> -d ./skills` |+| `create` | Create from repos, docs, logs, or prompts | `skillnet create log.txt --model gpt-4o` |+| `evaluate` | Quality report | `skillnet evaluate ./my_skill` |+| `analyze` | Relationship graph | `skillnet analyze ./my_skills` |-> Use `skillnet <command> --help` for full options.+Use `skillnet <command> --help` for full options.### Search@@ -280,24 +319,15 @@ skillnet search "visualization" --category "Development" --sort-by stars --limitskillnet download https://github.com/anthropics/skills/tree/main/skills/algorithmic-artskillnet download <url> -d ./my_agent/skillsskillnet download <private_url> --token <your_github_token>--# Use a mirror for faster downloads in restricted networksskillnet download <url> --mirror https://ghfast.top/```### Create```bash-# From trajectory fileskillnet create ./logs/trajectory.txt -d ./generated_skills--# From GitHub reposkillnet create --github https://github.com/owner/repo--# From office document (PDF, PPT, Word)skillnet create --office ./docs/guide.pdf--# From promptskillnet create --prompt "A skill for extracting tables from images"```@@ -313,147 +343,144 @@ skillnet evaluate ./my_skills/tool --category "Development" --model gpt-4o```bashskillnet analyze ./my_agent_skills-skillnet analyze ./my_agent_skills --no-save # print only, don't write file+skillnet analyze ./my_agent_skills --no-saveskillnet analyze ./my_agent_skills --model gpt-4o```----## <a id="configuration"></a>⚙️ Configuration--### Environment Variables+## Configuration-| Variable | Required For | Default |-| :--------------- | :--------------------------------- | :-------------------------- |-| `API_KEY` | `create` · `evaluate` · `analyze` | — |-| `BASE_URL` | Custom LLM endpoint | `https://api.openai.com/v1` |-| `GITHUB_TOKEN` | Private repos / higher rate limits | — |-| `SKILLNET_MODEL` | Default LLM model for all commands | `gpt-4o` |-| `GITHUB_MIRROR` | Faster downloads in restricted networks | — |+| Variable | Required for | Default |+| :--- | :--- | :--- |+| `API_KEY` | `create`, `evaluate`, `analyze` | - |+| `BASE_URL` | Custom OpenAI-compatible endpoint | `https://api.openai.com/v1` |+| `GITHUB_TOKEN` | Private repositories or higher rate limits | - |+| `SKILLNET_MODEL` | Default LLM model for all commands | `gpt-4o` |+| `GITHUB_MIRROR` | Faster GitHub downloads in restricted networks | - |-> `search` and `download` (public repos) work without any credentials.->-> **Recommended mirror:** [`https://ghfast.top/`](https://ghfast.top/) — set `GITHUB_MIRROR` or pass `--mirror` to speed up downloads in restricted networks.+`search` and public GitHub downloads work without credentials.-**Linux / macOS:**+Linux and macOS:```bash-export API_KEY="sk-..."-export BASE_URL="https://..." # optional+export API_KEY="YOUR_API_KEY"+export BASE_URL="https://..."```-**Windows PowerShell:**+Windows PowerShell:```powershell-$env:API_KEY = "sk-..."-$env:BASE_URL = "https://..." # optional+$env:API_KEY = "YOUR_API_KEY"+$env:BASE_URL = "https://..."```----## 🔬 Example: Scientific Discovery--A complete end-to-end demo showing how an AI Agent uses SkillNet to autonomously plan and execute a complex scientific workflow — from raw scRNA-seq data to a cancer target validation report.-----<table>-<tr><td>1️⃣</td><td><b>Task</b></td><td>User provides a goal: "Analyze scRNA-seq data to find cancer targets"</td></tr>-<tr><td>2️⃣</td><td><b>Plan</b></td><td>Agent decomposes into: Data → Mechanism → Validation → Report</td></tr>-<tr><td>3️⃣</td><td><b>Discover</b></td><td><code>client.search()</code> finds <em>cellxgene-census</em>, <em>kegg-database</em>, etc.</td></tr>-<tr><td>4️⃣</td><td><b>Evaluate</b></td><td>Skills are quality-gated via <code>client.evaluate()</code> before use</td></tr>-<tr><td>5️⃣</td><td><b>Execute</b></td><td>Skills run sequentially to produce a final discovery report</td></tr>-</table>--👉 **[Try the Interactive Demo](http://skillnet.openkg.cn/)** (Website → Scenarios → Science)- | -📓 **[View Notebook](https://github.com/zjunlp/SkillNet/blob/main/examples/scientific_workflow_demo.ipynb)**-------## 🤖 Use SkillNet in Code Agents--SkillNet itself is packaged as a portable agent skill at [`skills/skillnet/`](https://github.com/zjunlp/SkillNet/tree/main/skills/skillnet). Install this folder into your code agent's local skills directory, then the agent can search, download, create, evaluate, and organize skills during coding tasks.--+## REST API-https://github.com/user-attachments/assets/ae6020d9-6846-4672-84ce-fa9c8057e92b+The SkillNet search API is public and requires no authentication.+```bash+# Keyword search+curl "http://api-skillnet.openkg.cn/v1/search?q=pdf&sort_by=stars&limit=5"+# Semantic search+curl "http://api-skillnet.openkg.cn/v1/search?q=reading%20charts&mode=vector&threshold=0.8"+```<details>-<summary><b>Claude Code</b></summary>+<summary><b>Full parameter reference</b></summary>-Claude Code discovers user skills from `~/.claude/skills/` and project skills from `.claude/skills/`.+**Endpoint:** `GET http://api-skillnet.openkg.cn/v1/search`-Install as a user skill:+| Parameter | Type | Default | Description |+| :--- | :--- | :--- | :--- |+| `q` | string | required | Search query, keywords or natural language |+| `mode` | string | `keyword` | `keyword` or `vector` |+| `category` | string | - | Filter: Development, AIGC, Research, Science, etc. |+| `limit` | int | `10` | Results per page, max 50 |+| `page` | int | `1` | Page number, keyword mode only |+| `min_stars` | int | `0` | Minimum star count, keyword mode only |+| `sort_by` | string | `stars` | `stars` or `recent`, keyword mode only |+| `threshold` | float | `0.8` | Similarity threshold from 0.0 to 1.0, vector mode only |-```bash-git clone https://github.com/zjunlp/SkillNet.git-cd SkillNet+**Response:**-mkdir -p ~/.claude/skills-cp -R skills/skillnet ~/.claude/skills/skillnet+```json+{+ "data": [+ {+ "skill_name": "pdf-extractor-v1",+ "skill_description": "Extracts text and tables from PDF documents.",+ "author": "openkg-team",+ "stars": 128,+ "skill_url": "https://...",+ "category": "Productivity",+ "evaluation": {+ "safety": { "level": "Good", "reason": "..." }+ }+ }+ ],+ "meta": {+ "query": "pdf",+ "mode": "keyword",+ "total": 1,+ "limit": 10+ },+ "success": true+}```-Or install as a project-local skill:+</details>-```bash-mkdir -p .claude/skills-cp -R /path/to/SkillNet/skills/skillnet .claude/skills/skillnet-```+----Restart Claude Code or start a new session, then try:+## Examples and experiments-```text-Use SkillNet to search for a docker skill and summarize the top result.-```+### Scientific discovery-</details>+SkillNet can help an agent plan and execute a scientific workflow, from raw scRNA-seq data to a cancer target validation report.-<details>-<summary><b>Codex</b></summary>+-Codex discovers user skills from `$CODEX_HOME/skills`. If `CODEX_HOME` is not set, use `~/.codex/skills`.+| Step | What happens |+| :--- | :--- |+| Task | User asks: "Analyze scRNA-seq data to find cancer targets" |+| Plan | Agent decomposes the job into data, mechanism, validation, and report steps |+| Discover | `client.search()` finds useful skills such as `cellxgene-census` and `kegg-database` |+| Evaluate | Skills are quality-gated before use |+| Execute | Skills run in sequence and produce the final report |-```bash-git clone https://github.com/zjunlp/SkillNet.git-cd SkillNet+[Try the interactive demo](http://skillnet.openkg.cn/) or open the [scientific workflow notebook](https://github.com/zjunlp/SkillNet/blob/main/examples/scientific_workflow_demo.ipynb).-CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"-mkdir -p "$CODEX_HOME/skills"-cp -R skills/skillnet "$CODEX_HOME/skills/skillnet"-```+### Benchmark scripts-Restart Codex or start a new session, then try:+Reproduction scripts for ALFWorld, WebShop, and ScienceWorld are available under [`experiments/`](https://github.com/zjunlp/SkillNet/tree/main/experiments).-```text-Use $skillnet to search for a LangGraph skill before planning this task.-```+```bash+cd experiments-</details>+python alfworld_run.py --model o4-mini --split dev --max_workers 10 --exp_name alf_test --use_skill+python scienceworld_run.py --model o4-mini --split test --max_workers 5 --exp_name sci_test --use_skill+python webshop_run.py --model o4-mini --max_workers 3 --exp_name web_test --use_skill+```----## 🤖 OpenClaw Integration+## More integrations-SkillNet integrates with [OpenClaw](https://github.com/openclaw/openclaw) as a built-in, lazy-loaded skill. Once installed, your agent automatically:+### OpenClaw-- **Searches** existing skills before starting complex tasks-- **Creates** new skills from repos, documents, or completed work-- **Evaluates & analyzes** your local library for quality and inter-skill relationships+SkillNet integrates with [OpenClaw](https://github.com/openclaw/openclaw) as a built-in, lazy-loaded skill. The agent can search, download, create, evaluate, and analyze skills from inside OpenClaw.-> Community skills guide execution → successful outcomes become new skills → periodic analysis keeps the library clean.+<div align="center">-<details>-<summary><b>📡 Full Usage Reference</b></summary>--### 📥 Installation+https://github.com/user-attachments/assets/9d49a00c-827d-47a4-8954-0e6b977ca547-**Prerequisites:** [OpenClaw](https://github.com/openclaw/openclaw) installed (default workspace: `~/.openclaw/workspace`)+</div>-**Option A — CLI:**+Install with the CLI:```bashnpm i -g clawhub@@ -461,19 +488,13 @@ clawhub install skillnet --workdir ~/.openclaw/workspaceopenclaw gateway restart```-**Option B — Via OpenClaw chat:**+Or ask OpenClaw:-```+```textInstall the skillnet skill from ClawHub.```-### ⚙️ Configuration--The same three parameters (`API_KEY`, `BASE_URL`, `GITHUB_TOKEN`) apply here — see [Configuration](#configuration) for details.--In OpenClaw, you can pre-configure them in `openclaw.json` so the agent uses them silently — no prompts, no interruptions. If not configured, the agent only asks when a command actually needs the value, injects it for that single call, and never pollutes the global environment.--**Recommended: pre-configure in `openclaw.json`**:+Optional OpenClaw configuration:```json{@@ -481,10 +502,10 @@ In OpenClaw, you can pre-configure them in `openclaw.json` so the agent uses the"entries": {"skillnet": {"enabled": true,- "apiKey": "sk-REPLACE_ME",+ "apiKey": "YOUR_API_KEY","env": {"BASE_URL": "https://api.openai.com/v1",- "GITHUB_TOKEN": "ghp_REPLACE_ME"+ "GITHUB_TOKEN": "YOUR_GITHUB_TOKEN"}}}@@ -492,41 +513,11 @@ In OpenClaw, you can pre-configure them in `openclaw.json` so the agent uses the}```-### 🧪 Quick Verification--In your OpenClaw chat, try:--**No credentials needed:**--```-Search SkillNet for a "docker" skill and summarize the top result.-```--**Requires API key:**+### Model Context Protocol (MCP)-```-Create a skill from this GitHub repo: https://github.com/owner/repo (then evaluate it).-```--> The skill source is also available at [`skills/skillnet/`](skills/skillnet/) for reference.+The SkillNet MCP server is maintained by [CycleChain](https://github.com/CycleChain). It lets MCP-compatible clients such as Claude Desktop, Cursor, Antigravity, and Windsurf call SkillNet tools directly.-</details>-------## 🔌 Model Context Protocol (MCP) Integration--The **SkillNet MCP Server** (maintained by [CycleChain](https://github.com/CycleChain)) is a high-performance bridge that enables AI agents (such as Claude Desktop, Cursor, Antigravity and Windsurf) to interact with the SkillNet ecosystem using the [Model Context Protocol](https://modelcontextprotocol.io/).--It empowers agents to autonomously search, download, create, and evaluate 500,000+ specialized skills directly within your IDE or desktop environment.--<details>-<summary><b>📡 Full Usage Reference</b></summary>--### Installation Options--#### 1. Source Build (Node.js & Python)-Ideal for users who want to run the server locally with existing dependencies.+Source build:```bashgit clone https://github.com/CycleChain/skillnet-mcp@@ -534,19 +525,14 @@ cd skillnet-mcpnpm install && npm run build```-#### 2. Docker (Dependency-free)--The most robust way to run the server using the official image from [Docker Hub](https://hub.docker.com/r/fmdogancan/skillnet-mcp).+Docker:```bashdocker pull fmdogancan/skillnet-mcp:latest```-### Quick Configuration (Claude Desktop)--Add the following to your `claude_desktop_config.json`:+Claude Desktop configuration with Docker:-#### Option A: Docker (Recommended)```json{"mcpServers": {@@ -554,76 +540,58 @@ Add the following to your `claude_desktop_config.json`:"command": "docker","args": ["run", "-i", "--rm", "fmdogancan/skillnet-mcp:latest"],"env": {- "API_KEY": "your_api_key_here"+ "API_KEY": "YOUR_API_KEY"}}}}```-#### Option B: Build Locally If you prefer to build the image yourself from the source:--```bash-docker build -t skillnet-mcp-local .-```+`search_skills` and `download_skill` do not require an API key. `create`, `evaluate`, and `analyze` do.-_(Then, replace `fmdogancan/skillnet-mcp:latest` with `skillnet-mcp-local` in the JSON config above)_+### JiuwenClaw-#### Option C: Source Build+[JiuwenClaw](https://github.com/openJiuwen-ai/jiuwenclaw) integrates SkillNet as a built-in skill marketplace. See the [JiuwenClaw guide](./examples/JiuwenClaw/README.md).-```json-{- "mcpServers": {- "skillnet": {- "command": "node",- "args": ["/absolute/path/to/skillnet-mcp/build/index.js"],- "env": {- "API_KEY": "your_api_key_here"- }- }- }-}-```+----> **Note:** `search_skills` and `download_skill` tools do not require an API key. An `API_KEY` is only required for `create`, `evaluate`, and `analyze` features.+## Roadmap-### Supported Environment Variables+SkillNet is growing beyond search and installation.-* `API_KEY`: Your API key-* `GITHUB_TOKEN`: GitHub token for private repositories+- **SkillFabric:** workflow-level skill substrates and routing across skill collections.+- **SkillGym:** lifecycle evaluation and training environments for skills.-</details>+Start from [skillnet.openkg.cn](http://skillnet.openkg.cn/) and open SkillFabric or SkillGym from the website navigation.----## 🤝 Contributing--Contributions of all kinds are welcome! Whether it's fixing a typo, adding a feature, or sharing a new skill — every contribution counts.+## Contributing-1. **Fork** the repository-2. **Create** a feature branch (`git checkout -b feat/amazing-feature`)-3. **Commit** your changes (`git commit -m 'feat: add amazing feature'`)-4. **Push** to the branch (`git push origin feat/amazing-feature`)-5. **Open** a Pull Request+Contributions are welcome: bug fixes, docs, examples, and new skills all help.-📤 **[Contribute skills](http://skillnet.openkg.cn/)** (Website → Contribute → Submit via URL / Upload Local Skill / Batch Upload Skills)+1. Fork the repository.+2. Create a feature branch: `git checkout -b feat/amazing-feature`.+3. Commit your changes: `git commit -m 'feat: add amazing feature'`.+4. Push to the branch: `git push origin feat/amazing-feature`.+5. Open a pull request.-You can also [open an Issue](https://github.com/zjunlp/SkillNet/issues) to report bugs or suggest features.+You can also [open an issue](https://github.com/zjunlp/SkillNet/issues) or contribute skills through the [SkillNet website](http://skillnet.openkg.cn/).----## 📚 Citation+## Citation-If you find this work useful, please kindly ⭐ the repo and cite our paper!+If SkillNet helps your work, please cite the paper:```bibtex@misc{liang2026skillnetcreateevaluateconnect,- title={SkillNet: Create, Evaluate, and Connect AI Skills},+ title={SkillNet: Create, Evaluate, and Connect AI Skills},author={Yuan Liang and Ruobin Zhong and Haoming Xu and Chen Jiang and Yi Zhong and Runnan Fang and Jia-Chen Gu and Shumin Deng and Yunzhi Yao and Mengru Wang and Shuofei Qiao and Xin Xu and Tongtong Wu and Kun Wang and Yang Liu and Zhen Bi and Jungang Lou and Yuchen Eleanor Jiang and Hangcheng Zhu and Gang Yu and Haiwen Hong and Longtao Huang and Hui Xue and Chenxi Wang and Yijun Wang and Zifei Shan and Xi Chen and Zhaopeng Tu and Feiyu Xiong and Xin Xie and Peng Zhang and Zhengke Gui and Lei Liang and Jun Zhou and Chiyu Wu and Jin Shang and Yu Gong and Junyu Lin and Changliang Xu and Hongjie Deng and Wen Zhang and Keyan Ding and Qiang Zhang and Fei Huang and Ningyu Zhang and Jeff Z. Pan and Guilin Qi and Haofen Wang and Huajun Chen},year={2026},eprint={2603.04448},archivePrefix={arXiv},primaryClass={cs.AI},- url={https://arxiv.org/abs/2603.04448},+ url={https://arxiv.org/abs/2603.04448}}```