skill-weave 0.3.0__tar.gz

skill_weave-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FeiMing Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

skill_weave-0.3.0/PKG-INFO

@@ -0,0 +1,296 @@
+Metadata-Version: 2.4
+Name: skill-weave
+Version: 0.3.0
+Summary: Adaptive skill routing for multi-agent systems
+Author: FeiMing Studio
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Hxh-yaoxing/skill-weave
+Project-URL: Repository, https://github.com/Hxh-yaoxing/skill-weave
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# 🧶 Skill Weave
+
+**Routing that learns. Chains that self-correct. Zero install to try.**
+
+[![Python](https://img.shields.io/badge/python-3.10+-blue)](https://pypi.org/project/skill-weave)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-20%2F20-brightgreen)](tests/)
+[![Release](https://img.shields.io/github/v/release/Hxh-yaoxing/skill-weave)](https://github.com/Hxh-yaoxing/skill-weave/releases)
+[![Colab](https://img.shields.io/badge/▶%20Try%20Now-Colab-orange)](https://colab.research.google.com/github/Hxh-yaoxing/skill-weave/blob/main/notebooks/skill_weave_demo.ipynb)
+
+<br>
+
+> **What makes it special:** A three-stage routing pipeline that shrinks 141 candidate skills to 15 *before* any LLM call. An online learner that gets smarter every time you use it. A weaver that chains skills into DAGs instead of picking just one.
+>
+> **95.7% accuracy. 81% fewer tokens. 20 tests. Zero required dependencies.**
+
+---
+
+## 🔥 Why This Exists
+
+Multi-agent systems drown in their own skills.
+
+| Problem | Why It Hurts | How Skill Weave Fixes It |
+|---------|-------------|--------------------------|
+| **Keyword routing** breaks under overlap | "deploy" vs "ssh-deploy" vs "docker-deploy" all match | 4-dim weighted scoring: semantic × recency × success × cost |
+| **Static tables** rot silently | Add/remove one skill, the whole map breaks | Dynamic registration + online learning from every route |
+| **Flat LLM routing** burns tokens | 141 skills = 141 candidates to rank. Every. Single. Time. | 3-stage cascade: Tree Filter (141→15) → BM25 → LLM Re-rank |
+
+---
+
+## 🆚 How It Compares
+
+| Feature | Skill Weave | Keyword Match | LangChain Router | Semantic Kernel |
+|---------|-------------|---------------|------------------|-----------------|
+| Zero-dependency core | ✅ | ✅ | ❌ | ❌ |
+| 3-stage cascade pipeline | ✅ | ❌ | ❌ | ❌ |
+| Online learning from outcomes | ✅ | ❌ | ❌ | ❌ |
+| Multi-skill DAG weaving | ✅ | ❌ | ❌ | ❌ |
+| Chinese-English synonym match | ✅ | ❌ | ❌ | ❌ |
+| Production-tested (141 skills) | ✅ | — | — | — |
+| Token cost per route | 0–2K | 0 | ∞ (flat) | ∞ (flat) |
+
+> **Bottom line:** Keyword matching is fast but brittle. LangChain/SK handle semantics but burn tokens on every call. Skill Weave does both — cascade filtering + semantic re-rank — with learning on top.
+
+---
+
+## 🎮 Try It Now
+
+No install. No API key. 10 seconds.
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Hxh-yaoxing/skill-weave/blob/main/notebooks/skill_weave_demo.ipynb)
+
+Four interactive demos: basic routing → active learning → skill weaving → multi-plan comparison.
+
+---
+
+## 📦 Install
+
+```bash
+# From GitHub (recommended until PyPI listing is complete)
+pip install git+https://github.com/Hxh-yaoxing/skill-weave.git
+
+# Coming soon: pip install skill-weave
+```
+
+---
+
+## ⚡ 30-Second Quick Start
+
+```python
+from skill_weave import SkillRouter
+
+router = SkillRouter()
+router.register_skill("deploy",   metadata="deploy to production, handle rollback")
+router.register_skill("monitor",  metadata="monitor health metrics, alert on anomalies")
+router.register_skill("rollback", metadata="revert failed deployments")
+
+results = router.route("The new deploy broke everything, we need to go back")
+for r in results:
+    print(f"{r.skill.name}: {r.score:.2f}")
+# → rollback: 0.68
+# → deploy:   0.54
+# → monitor:  0.42
+```
+
+*It chose `rollback` — even though the query never said "rollback". That's semantic routing.*
+
+---
+
+## 🧠 The Pipeline
+
+```mermaid
+flowchart TD
+    TASK["💬 Task: 'deploy broke, revert now'"]
+    
+    TASK --> L1
+    
+    subgraph L1["L1: Tree Filter (zero token)"]
+        T1["'deploy' → infrastructure → 37 matches"]
+        T2["'revert' → narrows to 4 candidates"]
+        T1 --> T2
+    end
+    
+    L1 --> L2
+    
+    subgraph L2["L2: BM25 Rank (<50ms)"]
+        B1["Statistical scoring over 4 candidates"]
+        B2["rollback: 0.68 | deploy: 0.54"]
+        B1 --> B2
+    end
+    
+    L2 --> L3
+    
+    subgraph L3["L3: LLM Re-rank (optional, ~1s)"]
+        R1["Semantic understanding over top ~10"]
+        R2["Accuracy: 69.6% → 95.7%"]
+        R1 --> R2
+    end
+    
+    L3 --> OUTPUT["✅ rollback (score: 0.92)"]
+```
+
+| Stage | What It Does | Token Cost | Latency |
+|-------|-------------|------------|---------|
+| **L1: Tree Filter** | Hierarchy + synonym match → narrows 141→~15 | **0** | <1ms |
+| **L2: BM25** | Character 2-gram (中文) + word-level (EN) retrieval | **0** | <50ms |
+| **L3: LLM Re-rank** | Deep semantic reasoning over ~10 candidates | ~2K | ~1s |
+
+---
+
+## 📖 API Reference
+
+### `SkillRouter` — Zero-dependency core
+
+```python
+router = SkillRouter(
+    alpha=0.45,    # semantic weight
+    beta=0.20,     # recency weight
+    gamma=0.25,    # success rate weight
+    delta=0.10,    # cost weight
+)
+router.register_skill(name, metadata="...", tags=[...], avg_cost=1.0)
+router.unregister_skill(name)
+router.route(task, top_k=5, max_cost=None, tags_filter=None)  → list[RouteResult]
+router.record_outcome(skill_name, success=True, cost=1.0)
+router.skills  → dict[str, Skill]
+```
+
+### `SkillWeave` — Production 3-stage pipeline
+
+```python
+sw = SkillWeave(skill_dir="/path/to/skills", llm_rank_fn=my_llm_fn)
+sw.route(query, top_k=5, exclude_tier3=True)  → list[dict]
+sw.run_benchmark(queries, verbose=True)        → {"accuracy": 0.957, ...}
+sw.stats                                       → {"total_skills": 141, ...}
+```
+
+### `FeedbackLearner` — Online weight adjustment
+
+```python
+learner = FeedbackLearner(router)
+learner.route(task, explore=True)              # UCB bandit exploration
+learner.record(skill_name, task, success=True,
+               dimension_contributions={"semantic": 0.9, ...})
+learner.stats()                                # weight changes + success rates
+learner.reset()                                # restore original weights
+```
+
+### `WeavePlanner` — Multi-skill DAG orchestration
+
+```python
+planner = WeavePlanner(router)
+planner.register_chain_simple("pipeline", ["fetch", "parse", "store"])
+planner.register_chain("ci-cd", ["deploy", "monitor"],
+    conditions={1: ("'error' in str(output)", "rollback")})
+planner.plan("run the ci-cd pipeline")          → WeaveChain
+planner.plan_deep("complex task", max_depth=3)  → list[list[str]]
+planner.record_chain_outcome("pipeline", True)  # track chain success
+```
+
+### `annotate` — Skill metadata management
+
+```python
+from skill_weave import annotate_skill, inject_annotations, load_skill_metadata
+
+dims = annotate_skill("path/to/SKILL.md")       # generate 4-dim metadata
+inject_annotations("path/to/SKILL.md", dims)    # write into frontmatter
+skills = load_skill_metadata("/skill/dir")      # scan all skill metadata
+```
+
+---
+
+## 📊 Real-World Performance
+
+Deployed in production routing **141 skills** across **63 categories**:
+
+```
+           BM25 only           + LLM Re-rank
+Accuracy   ████████░░ 69.6%    ██████████ 95.7%
+Tokens     0                   ~2K per query
+Latency    <50ms               ~1s
+```
+
+23-query benchmark included in the repo (`benchmark/queries.json`).
+
+---
+
+## 🗺️ Architecture
+
+```
+skill_weave/
+├── router.py        SkillRouter — 4-dim weighted scoring (zero-dependency)
+├── advanced.py      SkillWeave  — 3-stage pipeline + BM25 + TreeFilter
+├── annotate.py      Annotation  — 4-dim metadata generation + injection
+├── learner.py       Learning    — UCB bandit + gradient weight adjustment
+└── weaver.py        Weaving     — DAG orchestration (chains, parallel, conditional)
+
+benchmark/queries.json     23 real-world routing test cases
+notebooks/demo.ipynb       Colab: try before you read
+tests/                     20 tests, all passing
+```
+
+---
+
+## 🤝 Contributing
+
+Skill Weave is built by **FeiMing Studio** — a small team of humans and AI agents building together.
+
+We welcome contributions. Before diving in:
+
+1. **Browse the [Colab demo](https://colab.research.google.com/github/Hxh-yaoxing/skill-weave/blob/main/notebooks/skill_weave_demo.ipynb)** — understand what the project does
+2. **Read [CONTRIBUTING.md](CONTRIBUTING.md)** — setup, conventions, commit style
+3. **Open an issue** — discuss before coding large changes
+4. **Run the tests** — `python tests/test_router.py && python tests/test_learner.py`
+
+We use **conventional commits** (`feat:`, `fix:`, `docs:`) and squash-merge to `main`.
+
+### Development Setup
+
+```bash
+git clone https://github.com/Hxh-yaoxing/skill-weave.git
+cd skill-weave
+pip install -e ".[dev]"
+python tests/test_router.py   # 9 tests
+python tests/test_learner.py  # 11 tests
+```
+
+---
+
+## 📊 Status & Roadmap
+
+Active development. Core pipeline stable. Used daily in production.
+
+| Version | Date | Highlights |
+|---------|------|------------|
+| **0.3.0** | 2026-06-05 | Active learning (UCB), skill weaving (DAG), 20 tests |
+| **0.2.0** | 2026-06-05 | 3-stage pipeline, BM25, TreeFilter, annotation, benchmark |
+| **0.1.0** | 2026-06-05 | Core `SkillRouter` with 4-dim weighted scoring |
+
+**Up next:** v0.4 — async routing + embedding backends. [Full changelog →](CHANGELOG.md)
+
+---
+
+## 👥 Authors
+
+| Role | Name |
+|------|------|
+| **Engine & Architecture** | Hermes 深蓝 ([@Hxh-yaoxing](https://github.com/Hxh-yaoxing)) |
+| **Creative Direction & Co-creation** | 曜行 (He Xuheng) |
+| **Initial Scaffold** | Hermes 楚乔 |
+| **Infrastructure** | FeiMing Studio |
+
+*We're real people (and agents) who iterate fast, communicate openly, and ship on weekends. If you open an issue, a human will respond.*
+
+---
+
+## 📄 License
+
+MIT — use it, fork it, ship it.
+
+---
+
+*[FeiMing Studio](https://github.com/Hxh-yaoxing) — where humans and agents build together.*

skill_weave-0.3.0/README.md

@@ -0,0 +1,283 @@
+# 🧶 Skill Weave
+
+**Routing that learns. Chains that self-correct. Zero install to try.**
+
+[![Python](https://img.shields.io/badge/python-3.10+-blue)](https://pypi.org/project/skill-weave)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-20%2F20-brightgreen)](tests/)
+[![Release](https://img.shields.io/github/v/release/Hxh-yaoxing/skill-weave)](https://github.com/Hxh-yaoxing/skill-weave/releases)
+[![Colab](https://img.shields.io/badge/▶%20Try%20Now-Colab-orange)](https://colab.research.google.com/github/Hxh-yaoxing/skill-weave/blob/main/notebooks/skill_weave_demo.ipynb)
+
+<br>
+
+> **What makes it special:** A three-stage routing pipeline that shrinks 141 candidate skills to 15 *before* any LLM call. An online learner that gets smarter every time you use it. A weaver that chains skills into DAGs instead of picking just one.
+>
+> **95.7% accuracy. 81% fewer tokens. 20 tests. Zero required dependencies.**
+
+---
+
+## 🔥 Why This Exists
+
+Multi-agent systems drown in their own skills.
+
+| Problem | Why It Hurts | How Skill Weave Fixes It |
+|---------|-------------|--------------------------|
+| **Keyword routing** breaks under overlap | "deploy" vs "ssh-deploy" vs "docker-deploy" all match | 4-dim weighted scoring: semantic × recency × success × cost |
+| **Static tables** rot silently | Add/remove one skill, the whole map breaks | Dynamic registration + online learning from every route |
+| **Flat LLM routing** burns tokens | 141 skills = 141 candidates to rank. Every. Single. Time. | 3-stage cascade: Tree Filter (141→15) → BM25 → LLM Re-rank |
+
+---
+
+## 🆚 How It Compares
+
+| Feature | Skill Weave | Keyword Match | LangChain Router | Semantic Kernel |
+|---------|-------------|---------------|------------------|-----------------|
+| Zero-dependency core | ✅ | ✅ | ❌ | ❌ |
+| 3-stage cascade pipeline | ✅ | ❌ | ❌ | ❌ |
+| Online learning from outcomes | ✅ | ❌ | ❌ | ❌ |
+| Multi-skill DAG weaving | ✅ | ❌ | ❌ | ❌ |
+| Chinese-English synonym match | ✅ | ❌ | ❌ | ❌ |
+| Production-tested (141 skills) | ✅ | — | — | — |
+| Token cost per route | 0–2K | 0 | ∞ (flat) | ∞ (flat) |
+
+> **Bottom line:** Keyword matching is fast but brittle. LangChain/SK handle semantics but burn tokens on every call. Skill Weave does both — cascade filtering + semantic re-rank — with learning on top.
+
+---
+
+## 🎮 Try It Now
+
+No install. No API key. 10 seconds.
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Hxh-yaoxing/skill-weave/blob/main/notebooks/skill_weave_demo.ipynb)
+
+Four interactive demos: basic routing → active learning → skill weaving → multi-plan comparison.
+
+---
+
+## 📦 Install
+
+```bash
+# From GitHub (recommended until PyPI listing is complete)
+pip install git+https://github.com/Hxh-yaoxing/skill-weave.git
+
+# Coming soon: pip install skill-weave
+```
+
+---
+
+## ⚡ 30-Second Quick Start
+
+```python
+from skill_weave import SkillRouter
+
+router = SkillRouter()
+router.register_skill("deploy",   metadata="deploy to production, handle rollback")
+router.register_skill("monitor",  metadata="monitor health metrics, alert on anomalies")
+router.register_skill("rollback", metadata="revert failed deployments")
+
+results = router.route("The new deploy broke everything, we need to go back")
+for r in results:
+    print(f"{r.skill.name}: {r.score:.2f}")
+# → rollback: 0.68
+# → deploy:   0.54
+# → monitor:  0.42
+```
+
+*It chose `rollback` — even though the query never said "rollback". That's semantic routing.*
+
+---
+
+## 🧠 The Pipeline
+
+```mermaid
+flowchart TD
+    TASK["💬 Task: 'deploy broke, revert now'"]
+    
+    TASK --> L1
+    
+    subgraph L1["L1: Tree Filter (zero token)"]
+        T1["'deploy' → infrastructure → 37 matches"]
+        T2["'revert' → narrows to 4 candidates"]
+        T1 --> T2
+    end
+    
+    L1 --> L2
+    
+    subgraph L2["L2: BM25 Rank (<50ms)"]
+        B1["Statistical scoring over 4 candidates"]
+        B2["rollback: 0.68 | deploy: 0.54"]
+        B1 --> B2
+    end
+    
+    L2 --> L3
+    
+    subgraph L3["L3: LLM Re-rank (optional, ~1s)"]
+        R1["Semantic understanding over top ~10"]
+        R2["Accuracy: 69.6% → 95.7%"]
+        R1 --> R2
+    end
+    
+    L3 --> OUTPUT["✅ rollback (score: 0.92)"]
+```
+
+| Stage | What It Does | Token Cost | Latency |
+|-------|-------------|------------|---------|
+| **L1: Tree Filter** | Hierarchy + synonym match → narrows 141→~15 | **0** | <1ms |
+| **L2: BM25** | Character 2-gram (中文) + word-level (EN) retrieval | **0** | <50ms |
+| **L3: LLM Re-rank** | Deep semantic reasoning over ~10 candidates | ~2K | ~1s |
+
+---
+
+## 📖 API Reference
+
+### `SkillRouter` — Zero-dependency core
+
+```python
+router = SkillRouter(
+    alpha=0.45,    # semantic weight
+    beta=0.20,     # recency weight
+    gamma=0.25,    # success rate weight
+    delta=0.10,    # cost weight
+)
+router.register_skill(name, metadata="...", tags=[...], avg_cost=1.0)
+router.unregister_skill(name)
+router.route(task, top_k=5, max_cost=None, tags_filter=None)  → list[RouteResult]
+router.record_outcome(skill_name, success=True, cost=1.0)
+router.skills  → dict[str, Skill]
+```
+
+### `SkillWeave` — Production 3-stage pipeline
+
+```python
+sw = SkillWeave(skill_dir="/path/to/skills", llm_rank_fn=my_llm_fn)
+sw.route(query, top_k=5, exclude_tier3=True)  → list[dict]
+sw.run_benchmark(queries, verbose=True)        → {"accuracy": 0.957, ...}
+sw.stats                                       → {"total_skills": 141, ...}
+```
+
+### `FeedbackLearner` — Online weight adjustment
+
+```python
+learner = FeedbackLearner(router)
+learner.route(task, explore=True)              # UCB bandit exploration
+learner.record(skill_name, task, success=True,
+               dimension_contributions={"semantic": 0.9, ...})
+learner.stats()                                # weight changes + success rates
+learner.reset()                                # restore original weights
+```
+
+### `WeavePlanner` — Multi-skill DAG orchestration
+
+```python
+planner = WeavePlanner(router)
+planner.register_chain_simple("pipeline", ["fetch", "parse", "store"])
+planner.register_chain("ci-cd", ["deploy", "monitor"],
+    conditions={1: ("'error' in str(output)", "rollback")})
+planner.plan("run the ci-cd pipeline")          → WeaveChain
+planner.plan_deep("complex task", max_depth=3)  → list[list[str]]
+planner.record_chain_outcome("pipeline", True)  # track chain success
+```
+
+### `annotate` — Skill metadata management
+
+```python
+from skill_weave import annotate_skill, inject_annotations, load_skill_metadata
+
+dims = annotate_skill("path/to/SKILL.md")       # generate 4-dim metadata
+inject_annotations("path/to/SKILL.md", dims)    # write into frontmatter
+skills = load_skill_metadata("/skill/dir")      # scan all skill metadata
+```
+
+---
+
+## 📊 Real-World Performance
+
+Deployed in production routing **141 skills** across **63 categories**:
+
+```
+           BM25 only           + LLM Re-rank
+Accuracy   ████████░░ 69.6%    ██████████ 95.7%
+Tokens     0                   ~2K per query
+Latency    <50ms               ~1s
+```
+
+23-query benchmark included in the repo (`benchmark/queries.json`).
+
+---
+
+## 🗺️ Architecture
+
+```
+skill_weave/
+├── router.py        SkillRouter — 4-dim weighted scoring (zero-dependency)
+├── advanced.py      SkillWeave  — 3-stage pipeline + BM25 + TreeFilter
+├── annotate.py      Annotation  — 4-dim metadata generation + injection
+├── learner.py       Learning    — UCB bandit + gradient weight adjustment
+└── weaver.py        Weaving     — DAG orchestration (chains, parallel, conditional)
+
+benchmark/queries.json     23 real-world routing test cases
+notebooks/demo.ipynb       Colab: try before you read
+tests/                     20 tests, all passing
+```
+
+---
+
+## 🤝 Contributing
+
+Skill Weave is built by **FeiMing Studio** — a small team of humans and AI agents building together.
+
+We welcome contributions. Before diving in:
+
+1. **Browse the [Colab demo](https://colab.research.google.com/github/Hxh-yaoxing/skill-weave/blob/main/notebooks/skill_weave_demo.ipynb)** — understand what the project does
+2. **Read [CONTRIBUTING.md](CONTRIBUTING.md)** — setup, conventions, commit style
+3. **Open an issue** — discuss before coding large changes
+4. **Run the tests** — `python tests/test_router.py && python tests/test_learner.py`
+
+We use **conventional commits** (`feat:`, `fix:`, `docs:`) and squash-merge to `main`.
+
+### Development Setup
+
+```bash
+git clone https://github.com/Hxh-yaoxing/skill-weave.git
+cd skill-weave
+pip install -e ".[dev]"
+python tests/test_router.py   # 9 tests
+python tests/test_learner.py  # 11 tests
+```
+
+---
+
+## 📊 Status & Roadmap
+
+Active development. Core pipeline stable. Used daily in production.
+
+| Version | Date | Highlights |
+|---------|------|------------|
+| **0.3.0** | 2026-06-05 | Active learning (UCB), skill weaving (DAG), 20 tests |
+| **0.2.0** | 2026-06-05 | 3-stage pipeline, BM25, TreeFilter, annotation, benchmark |
+| **0.1.0** | 2026-06-05 | Core `SkillRouter` with 4-dim weighted scoring |
+
+**Up next:** v0.4 — async routing + embedding backends. [Full changelog →](CHANGELOG.md)
+
+---
+
+## 👥 Authors
+
+| Role | Name |
+|------|------|
+| **Engine & Architecture** | Hermes 深蓝 ([@Hxh-yaoxing](https://github.com/Hxh-yaoxing)) |
+| **Creative Direction & Co-creation** | 曜行 (He Xuheng) |
+| **Initial Scaffold** | Hermes 楚乔 |
+| **Infrastructure** | FeiMing Studio |
+
+*We're real people (and agents) who iterate fast, communicate openly, and ship on weekends. If you open an issue, a human will respond.*
+
+---
+
+## 📄 License
+
+MIT — use it, fork it, ship it.
+
+---
+
+*[FeiMing Studio](https://github.com/Hxh-yaoxing) — where humans and agents build together.*

skill_weave-0.3.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "skill-weave"
+version = "0.3.0"
+description = "Adaptive skill routing for multi-agent systems"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    {name = "FeiMing Studio"},
+]
+
+[project.urls]
+Homepage = "https://github.com/Hxh-yaoxing/skill-weave"
+Repository = "https://github.com/Hxh-yaoxing/skill-weave"
+
+[tool.setuptools.packages.find]
+include = ["skill_weave*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

skill_weave-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

skill_weave-0.3.0/skill_weave/__init__.py

@@ -0,0 +1,56 @@
+"""Skill Weave — Adaptive skill routing for multi-agent systems.
+
+Core router: 4-dimension weighted scoring (semantic × recency × success × cost).
+Advanced router: 3-stage pipeline (Tree Filter → BM25 → LLM Re-rank).
+Active learning: online weight adjustment via bandit + gradient feedback.
+Skill weaving: multi-skill DAG orchestration (chains, parallel, conditional).
+
+Production-proven with 141 real-world skills, 95.7% benchmark accuracy.
+"""
+
+from .router import Skill, RouteResult, SkillRouter
+
+# Lazy imports for optional heavy dependencies
+__all__ = [
+    "SkillRouter",
+    "SkillWeave",
+    "Skill",
+    "RouteResult",
+    "TreeFilter",
+    "BM25Scorer",
+    "FeedbackLearner",
+    "WeavePlanner",
+    "WeaveNode",
+    "WeaveEdge",
+    "WeaveChain",
+    "MergeStrategy",
+    "NodeType",
+    "annotate_skill",
+    "inject_annotations",
+    "load_skill_metadata",
+]
+
+__version__ = "0.3.0"
+
+
+def __getattr__(name: str):
+    if name == "SkillWeave":
+        from .advanced import SkillWeave as _SkillWeave
+        return _SkillWeave
+    if name == "TreeFilter":
+        from .advanced import TreeFilter as _TreeFilter
+        return _TreeFilter
+    if name == "BM25Scorer":
+        from .advanced import BM25Scorer as _BM25Scorer
+        return _BM25Scorer
+    if name in ("annotate_skill", "inject_annotations", "load_skill_metadata"):
+        from . import annotate as _annotate
+        return getattr(_annotate, name)
+    if name == "FeedbackLearner":
+        from .learner import FeedbackLearner as _FeedbackLearner
+        return _FeedbackLearner
+    if name in ("WeavePlanner", "WeaveNode", "WeaveEdge", "WeaveChain",
+                "MergeStrategy", "NodeType"):
+        from . import weaver as _weaver
+        return getattr(_weaver, name)
+    raise AttributeError(f"module 'skill_weave' has no attribute {name!r}")