Metadata-Version: 2.4
Name: unlimited-skills
Version: 0.6.8
Summary: A local-first capability router with skill retrieval, opt-in business context, and provider-governed learning.
Project-URL: Homepage, https://github.com/AI4sale/unlimited-skills
Project-URL: Repository, https://github.com/AI4sale/unlimited-skills
Project-URL: Issues, https://github.com/AI4sale/unlimited-skills/issues
Project-URL: Changelog, https://github.com/AI4sale/unlimited-skills/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/AI4sale/unlimited-skills/tree/main/docs
Author: AI4sale
License-Expression: MIT
License-File: LICENSE
Keywords: agents,chroma,claude-code,codex,memory,rag,retrieval,skills
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: cryptography<47,>=42
Requires-Dist: pyyaml<7,>=6
Provides-Extra: all
Requires-Dist: chromadb<2,>=1.0; extra == 'all'
Requires-Dist: fastapi>=0.115; extra == 'all'
Requires-Dist: fastembed>=0.4; extra == 'all'
Requires-Dist: uvicorn>=0.30; extra == 'all'
Provides-Extra: server
Requires-Dist: fastapi>=0.115; extra == 'server'
Requires-Dist: uvicorn>=0.30; extra == 'server'
Provides-Extra: vector
Requires-Dist: chromadb<2,>=1.0; extra == 'vector'
Requires-Dist: fastembed>=0.4; extra == 'vector'
Description-Content-Type: text/markdown

# Unlimited Skills

Unlimited Skills is a local-first skill memory and retrieval layer for coding
agents. It keeps large skill libraries out of the agent context and retrieves
the small, relevant skill context only when it is useful.

This is `v0.6.8` of the free MIT local core. There is no telemetry, no hosted
dependency for local use, and nothing for sale in this release. The project is
still pre-1.0, so APIs and JSON output may change before `1.0`.

Use `unlimited-skills==0.6.8` or newer after this release is published. The
`0.6.0` package was uploaded to PyPI but was not tagged or released because the
published verifier caught a CLI contract issue after upload.

## Install

```bash
pip install unlimited-skills
unlimited-skills quickstart
```

To avoid earlier uploaded-but-not-current artifacts explicitly, pin the
accepted v0.6 alpha floor:

```bash
pip install --upgrade "unlimited-skills>=0.6.8"
```

For hybrid/vector search:

```bash
pip install "unlimited-skills[vector]"
unlimited-skills vector-reindex
```

## Optional Local Business Context

An owner can configure a private local JSON-over-stdio adapter so card-mode
`suggest` returns the chosen skill plus cited business references. The public
package ships the bounded transport and policy boundary—not a company database,
credentials, or hosted dependency.

```bash
unlimited-skills context doctor --json
unlimited-skills context retrieve "current source-backed operating context" --json
```

Retrieved text is `retrieval_only`, treated as data rather than instructions,
and marked internal. `no_context` never means verified absence. The Claude Code
Stop hook never derives evidence from assistant prose. It only forwards an
explicit, bounded signed receipt supplied by a trusted host field or an
owner-controlled inbox. The private provider owns signature authentication,
acceptance, quarantine, idempotency, and durable writes.

## What Quickstart Proves

`unlimited-skills quickstart` is the first-value path for a clean install:

- imports the bundled ECC and Superpowers packs when your local library is
  empty;
- indexes the local skill library;
- runs a first search so you can see retrieval working;
- measures local MCP context savings when a Claude Code config is available;
- prints local next steps without uploading prompts, schemas, configs, or
  skill bodies.

The package smoke for this release verifies the wheel in a fresh virtual
environment: `unlimited-skills --version`, `quickstart`, `suggest`,
`mcp savings`, `feedback prepare`, `learning-summary --events`, and
`roi receipt` all run from the installed package. The v0.6.8 package smoke also
verifies retrieval precision and onboarding from a clean wheel install: weak
matches stay silent, mixed-language prompts request an English-keyword rescue,
quickstart completes missing bundled collections without touching local skills,
and the source release-gate verifier passes.

## Measured, Not Promised

Current release-gate measurements on the bundled library:

- skill retrieval eval: top-1 `0.933`, top-3 `0.967`, false positives `0`;
- MCP lab benchmark: `90,420` bytes of direct tool schemas versus `1,268`
  bytes behind the Unlimited Tools gateway.

Your local results depend on your installed skills and MCP servers. Run
`unlimited-skills mcp savings --json` to measure your own configuration.

## Local-First Boundaries

- No telemetry or automatic uploads.
- No skill execution by the library.
- No business provider is enabled by default. When explicitly configured, task
  queries and explicit signed completion receipts go only to that trusted local
  command.
- The Claude Code prompt hook may start the optional warm-search daemon on
  loopback; it never binds LAN/remote or uploads prompt data. Set
  `UNLIMITED_SKILLS_NO_AUTOSERVE=1` only for restricted runtimes.
- No paid, hosted, Team, Pro, Business, or Enterprise feature is required for
  local search, quickstart, suggestion, indexing, or MCP savings.
- Hosted/registered catalog and team surfaces are early alpha paths documented
  in the repository; they are not required for the local core.

## Useful Links

- Repository: https://github.com/AI4sale/unlimited-skills
- Quickstart docs: https://github.com/AI4sale/unlimited-skills/blob/main/docs/quickstart.md
- Feedback guide: https://github.com/AI4sale/unlimited-skills/blob/main/docs/feedback.md
- Known limitations: https://github.com/AI4sale/unlimited-skills/blob/main/docs/releases/v0.5.0-alpha-known-issues.md
- Security policy: https://github.com/AI4sale/unlimited-skills/blob/main/SECURITY.md
