Create, Evaluate, and Connect AI Skills
Python ai-agentsai-skillsartificial-intelligenceknowledge-graphlarge-language-modelsnatural-language-processingopenkgskillnetskills
release: prepare skillnet-ai 0.1.2 and document local UI
Icarus-Chen9e1d7977e602
diff --git a/README.md b/README.mdindex f8488d4..5629cb0 100644--- a/README.md+++ b/README.md@@ -16,7 +16,7 @@[](http://skillnet.openkg.cn/)[](https://stackmap.shipwithai.xyz/repos/zjunlp/skillnet?utm_source=badge)-[Website](http://skillnet.openkg.cn/) · [Python SDK](./skillnet-ai) · [Examples](./examples) · [Experiments](./experiments) · [Paper](https://arxiv.org/abs/2603.04448)+[Website](http://skillnet.openkg.cn/) · [Python SDK](./skillnet-ai) · [Local UI](#local-browser-interface) · [Examples](./examples) · [Experiments](./experiments) · [Paper](https://arxiv.org/abs/2603.04448)</div>@@ -41,6 +41,10 @@ SkillNet provides unified infrastructure for the agent skill lifecycle:## News+- **[Unreleased · 0.1.2]** A [**local browser interface**](#local-browser-interface)+ brings your skill folders, analyzed relationships, and source evidence into one+ view. Launch it with `skillnet ui`; browsing requires no model calls.+- **[2026-08-20]** The updated [**SkillNet report**](https://arxiv.org/abs/2603.04448) presents**SkillNet-Gym**, with executable benchmarks for skill construction, retrieval, and composition,and **SkillNet-Fabric**, which routes tasks through a Wiki built for each task.@@ -74,26 +78,36 @@ Explore the public skill library on [skillnet.openkg.cn](http://skillnet.openkg.The site also introduces [SkillNet-Gym](http://skillnet.openkg.cn/skillgym) for skill graph construction and lifecycle benchmarking, and [SkillNet-Fabric](http://skillnet.openkg.cn/skillfabric) for Wiki-based skill routing, including research results and a guided routing demo.-### Browse local skills+<div align="center">++https://github.com/user-attachments/assets/9f9d35b0-36fd-4d7d-a072-39afa380b241++</div>++---++## Local Browser InterfaceThe [browser interface](skillnet-ai/src/skillnet_ai/web/ui/README.md) is part of thePython package. Browse your own skill folders, inspect saved analysis graphs,and follow relationship evidence to the original source lines.+The interface is included in the upcoming **0.1.2** release. Until it is published+on PyPI, use the [source setup](skillnet-ai/src/skillnet_ai/web/ui/README.md#develop-and-build).+After release, install and launch it with:+```bash-pip install "skillnet-ai[ui]"+pip install "skillnet-ai[ui]>=0.1.2"skillnet ui --skills-dir "/absolute/path/to/skills"```-Released packages include the website; Node.js is only needed for UI development.-For this source checkout, follow the interface's build instructions before starting.-The interface makes no model calls and starts with an empty personal library.--<div align="center">+Open `http://127.0.0.1:8765`. Choose **Current skill files** to read the sources or+**Analysis results** to explore saved `compose_with` and `similar_to` relationships.+You can also import a `graph.json` generated by `skillnet analyze`.-https://github.com/user-attachments/assets/9f9d35b0-36fd-4d7d-a072-39afa380b241--</div>+Packaged releases include the website; users do not need Node.js or model keys+to browse. Generate analysis separately with the SDK or CLI, then view the same+results here. The interface starts with an empty personal library.---@@ -255,6 +269,7 @@ the `skillnet` command is unavailable on your PATH.| `evaluate` | Evaluate a local or remote skill | `skillnet evaluate ./my_skill` || `analyze` | Build a local scenario graph and index | `skillnet analyze ./my_skills --output-dir ./skillnet_index` || `route` | Select local skills for a task | `skillnet route "analyze my CSV" --index-dir ./skillnet_index` |+| `ui` | Browse local skills and saved analysis | `skillnet ui --skills-dir /absolute/path/to/skills` |Use `skillnet <command> --help` for full options, or see the[CLI examples](skillnet-ai/README.md#cli). Add `--json` for a structureddiff --git a/skillnet-ai/README.md b/skillnet-ai/README.mdindex 2614f06..50afeb1 100644--- a/skillnet-ai/README.md+++ b/skillnet-ai/README.md@@ -32,6 +32,9 @@ OpenAI-compatible Chat Completions endpoint. Analyze also needs an embeddingendpoint; route uses that same embedding endpoint and a separately configuredClaude or Codex Agent SDK.+The optional [browser interface](#browser-interface) opens local skills and saved+analysis results with `skillnet ui`.+For the full project overview, research context, integrations, and roadmap, see the [main SkillNet repository](https://github.com/zjunlp/SkillNet).---@@ -90,6 +93,7 @@ skillnet download <skill_url> -d ./my_skills| Evaluate skills | `client.evaluate(...)` | `skillnet evaluate ...` | Chat Completions API || Analyze relationships | `client.analyze(...)` | `skillnet analyze ...` | Chat Completions + embeddings || Route local skills | `client.route(...)` | `skillnet route ...` | Embeddings + Claude or Codex Agent SDK |+| Browse local skills | — | `skillnet ui` | None |---@@ -363,6 +367,40 @@ to update the index; editing generated Wiki pages does not update routing.Invalid model responses, damaged indexes, and SDK timeouts raise errors. A failedExplorer call does not return a substitute selection based on retrieval rank.+## Browser interface++The optional browser interface is included in the upcoming **0.1.2** release.+Until it is published on PyPI, use the+[source setup](https://github.com/zjunlp/SkillNet/blob/main/skillnet-ai/src/skillnet_ai/web/ui/README.md#develop-and-build).+After release:++```bash+pip install "skillnet-ai[ui]>=0.1.2"+skillnet ui --skills-dir "/absolute/path/to/skills"+```++The service opens `http://127.0.0.1:8765`. Omit `--skills-dir` to choose a folder+in the interface; use `--no-browser` to suppress opening a tab, or `--port` to+change the port. Stop it with Ctrl+C.++- Browse local `SKILL.md` files and search the skill list.+- Switch **View** to **Analysis results** to inspect saved `compose_with` and+ `similar_to` relationships in a graph or list, and follow evidence to source lines.+- Import a complete SDK `graph.json`, or read the analysis in a folder's `.skillnet/`+ directory. Generate analysis separately with `client.analyze(...)` or+ `skillnet analyze`; the interface makes no model calls.++Install `[ui,graph]` if you also want to generate analysis locally. Browsing+requires no model key, database, or Node.js. The six SDK methods keep their existing+APIs; `skillnet ui` is the browser launch command.++The implementation lives in `src/skillnet_ai/web/`: Python serves local data and+compiled assets, while `web/ui/` contains the React source. See the+[interface guide](https://github.com/zjunlp/SkillNet/blob/main/skillnet-ai/src/skillnet_ai/web/ui/README.md)+for storage, limits, and development details.++---+## CLIThe CLI is installed with the package. You can also invoke it as@@ -383,6 +421,7 @@ skillnet <command> --help| `evaluate` | Evaluate a local or remote skill | `skillnet evaluate ./my_skill` || `analyze` | Build a local scenario graph and index | `skillnet analyze ./my_skills --output-dir ./skillnet_index` || `route` | Select local skills for a task | `skillnet route "analyze my CSV" --index-dir ./skillnet_index` |+| `ui` | Browse local skills and saved analysis | `skillnet ui --skills-dir /absolute/path/to/skills` |### Search@@ -587,9 +626,12 @@ versions in `src/skillnet_ai/core/prompts.py` to invalidate obsolete cached resuFrom the `skillnet-ai/` directory:```bash-pip install -e ".[graph,dev,claude,codex]"+pip install -e ".[ui,graph,dev,claude,codex]"pytest -qmypy+# Build the website before producing a wheel or source distribution (Node.js 20 or 22+).+npm --prefix src/skillnet_ai/web/ui ci+npm --prefix src/skillnet_ai/web/ui run buildpython -m build```@@ -602,16 +644,3 @@ real skills and your configured providers.SkillNet is licensed under [MIT](https://github.com/zjunlp/SkillNet/blob/main/LICENSE).Skills from external repositories retain their own licenses.--## Browser interface--Install `pip install "skillnet-ai[ui]"` and run `skillnet ui` to browse local skill-folders and saved analysis results. Use `--skills-dir /absolute/path/to/skills`-to open a folder immediately, or `--no-browser` to start without opening a tab.-The service listens only on loopback and makes no model calls.--The implementation lives in `src/skillnet_ai/web/`: Python serves local data and-compiled assets, while `web/ui/` contains the React source. See the-[interface guide](src/skillnet_ai/web/ui/README.md) for source development, data-limits and building the website before packaging. Wheel and source releases-include compiled assets; end users do not need Node.js.diff --git a/skillnet-ai/pyproject.toml b/skillnet-ai/pyproject.tomlindex e46e8c8..d9640e9 100644--- a/skillnet-ai/pyproject.toml+++ b/skillnet-ai/pyproject.toml@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"[project]name = "skillnet-ai"-version = "0.1.1"+version = "0.1.2"description = "Official Python SDK for SkillNet: Create, Evaluate, and Connect AI Skills."readme = "README.md"authors = [{ name = "SkillNet Team", email = "[email protected]" }]diff --git a/skillnet-ai/src/skillnet_ai/searcher.py b/skillnet-ai/src/skillnet_ai/searcher.pyindex 926f302..243b790 100644--- a/skillnet-ai/src/skillnet_ai/searcher.py+++ b/skillnet-ai/src/skillnet_ai/searcher.py@@ -16,7 +16,7 @@ class SkillNetSearcher:self.skillnet_api_url = resolve_settings(skillnet_api_url=skillnet_api_url).skillnet_api_url.rstrip("/")self.session = requests.Session()self.session.headers.update({- "User-Agent": "SkillNet-Python-SDK/0.1.1"+ "User-Agent": "SkillNet-Python-SDK/0.1.2"})def search(diff --git a/skillnet-ai/src/skillnet_ai/web/ui/README.md b/skillnet-ai/src/skillnet_ai/web/ui/README.mdindex 27d2cd0..fb39c1d 100644--- a/skillnet-ai/src/skillnet_ai/web/ui/README.md+++ b/skillnet-ai/src/skillnet_ai/web/ui/README.md@@ -6,8 +6,11 @@ evaluates a skill, or executes skill scripts.## Use an installed release+The interface is part of the upcoming **skillnet-ai 0.1.2** release. Until it is+published on PyPI, follow [Develop and build](#develop-and-build). After release:+```bash-pip install "skillnet-ai[ui]"+pip install "skillnet-ai[ui]>=0.1.2"skillnet uiskillnet ui --skills-dir "/absolute/path/to/skills"```@@ -48,6 +51,7 @@ are reported; evidence always points to the source saved at analysis time.localStorage. Storage is specific to the browser and host/port.- Limits: 20 MB per import or source library, 5,000 skills, 20,000 relationships.The skill list shows the first 200 matches; search narrows the list.+## Develop and buildFrom `skillnet-ai/`, install the Python source and optional web dependencies:@@ -81,6 +85,8 @@ Use `npm run format:check` to check TypeScript/CSS formatting.Build the UI before building the Python package. From `skillnet-ai/`:```bash+npm --prefix src/skillnet_ai/web/ui ci+npm --prefix src/skillnet_ai/web/ui run buildpython -m build```