Skip to content

Create, Evaluate, and Connect AI Skills

release: prepare skillnet-ai 0.1.2 and document local UI

Icarus-Chen9e1d7977e602
diff --git a/README.md b/README.md
index f8488d4..5629cb0 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,7 @@
[![Website](https://img.shields.io/badge/Website-skillnet.openkg.cn-0078D4.svg)](http://skillnet.openkg.cn/)
[![On StackMap](https://img.shields.io/endpoint?url=https%3A%2F%2Fstackmap.shipwithai.xyz%2Fapi%2Fbadge%2Fskillnet.json)](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 Interface
The [browser interface](skillnet-ai/src/skillnet_ai/web/ui/README.md) is part of the
Python 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 structured
diff --git a/skillnet-ai/README.md b/skillnet-ai/README.md
index 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 embedding
endpoint; route uses that same embedding endpoint and a separately configured
Claude 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 failed
Explorer 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.
+
+---
+
## CLI
The 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 resu
From the `skillnet-ai/` directory:
```bash
-pip install -e ".[graph,dev,claude,codex]"
+pip install -e ".[ui,graph,dev,claude,codex]"
pytest -q
mypy
+# 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 build
python -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.toml
index 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.py
index 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.md
index 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 ui
skillnet 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 build
From `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 build
python -m build
```