Metadata-Version: 2.5
Name: bitranox-skills
Version: 5.303.2
Summary: The bitranox Claude Code skill collection: 82 skills and 64 hooks, installable without the plugin marketplace.
Project-URL: Homepage, https://github.com/bitranox/bitranox-skills
Project-URL: Repository, https://github.com/bitranox/bitranox-skills
Project-URL: Changelog, https://github.com/bitranox/bitranox-skills/blob/master/CHANGELOG.md
Author: bitranox
License: MIT License
        
        Copyright (c) 2026 bitranox
        
        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.
        
        Portions of this collection are adapted from third-party skills under their own
        permissive licenses. Those portions retain their original copyright notices;
        see plugins/bitranox/THIRD_PARTY_NOTICES.md for the per-skill attributions and
        license texts.
License-File: LICENSE
Keywords: agent-skills,ai-agents,anthropic,claude,claude-code
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# bitranox-skills

**A Claude Code plugin that learns your way of working.** It notices when a session teaches
something - a correction, a rule you state, a mistake worth not repeating - captures it as durable
memory, sleeps on it, and files each lesson exactly where it applies: this project, this group of
projects, or everything you do. On top of that self-learning memory it ships **82 skills** of
software-engineering craft - planning, debugging, code review, clean architecture, language and
tool references, humanizing prose - refined over real day-to-day work and growing with every
lesson that proves broadly useful.

The result compounds: the same correction is never made twice, knowledge from one project is on
the desk when a sibling project needs it, and routines harden into skills instead of being
re-derived every time.

## Quick start

```text
/plugin marketplace add bitranox/bitranox-skills
/plugin install bitranox@bitranox-skills
```

Install at **user scope** (the default) - the memory files lessons across projects, so it must
run everywhere. Then enable auto-update once via `/plugin` -> **Marketplaces** ->
`bitranox-skills` -> **Enable auto-update**. Windows needs
[Git for Windows](https://gitforwindows.org/); details and verification in
[docs/installation.md](docs/installation.md).

Skills are invoked as `/bitranox:<skill>`, and Claude picks one up automatically whenever a task
matches its description.

### Without the plugin marketplace

The same skills also ship as a Python package, for a machine where you would rather not add a
marketplace, or where you want a pinned version:

```bash
uv tool install bitranox-skills
bitranox-skills install
```

That copies all 82 skills into `~/.claude/skills/`, where Claude Code picks them up as personal
skills. It leaves anything already there alone unless you pass `--force`, `--dry-run` reports the
plan without writing, and `--dest` targets a different directory. `bitranox-skills path` prints
where the bundled copy lives, including the `hooks/` directory - the hooks need entries in your
`settings.json`, which this command deliberately does not write for you.

The package version and the plugin version are the same number, so `uv tool install
bitranox-skills==5.293.0` and the marketplace's 5.293.0 are the same skills.

## The book

| Chapter                               | What it answers                                                                      |
|---------------------------------------|--------------------------------------------------------------------------------------|
| [Concepts](docs/concepts.md)          | The ideas: learn as you go, sleep on it, file knowledge by reach - in plain language |
| [Installation](docs/installation.md)  | Install, auto-update, Windows, verifying the setup                                   |
| [Setup](docs/setup.md)                | First-session decisions: knobs, tree shape, iron rules, seeding a project            |
| [Usage](docs/usage.md)                | The daily flow: capture, recall, the nap/tree/crosstree consolidation ladder         |
| [Skill catalog](docs/skills.md)       | All 82 skills with their triggers, grouped by domain (generated, cannot rot)         |
| [Architecture](docs/architecture.md)  | Store format, the write engine, the hook pipeline, guards, delivery paths            |
| [Reference](docs/reference.md)        | Every knob, sentinel file, env var, CLI command, and quirk                           |
| [Contributing](CONTRIBUTING.md)       | Authoring skills, the quality gates, proposing changes upstream                      |
| [AI transparency](ai-transparency.md) | Where AI is used in this repo, what is verified, and how to check it yourself        |

## Repo layout

This repo is both the marketplace (`.claude-plugin/marketplace.json`) and the single plugin it
ships (`plugins/bitranox/`): the skills live in `plugins/bitranox/skills/`, the hooks in
`plugins/bitranox/hooks/`.

## Credits

Most skills are custom-built or adapted. Some general workflow skills (brainstorming,
systematic-debugging, test-driven-development, verification-before-completion) originate from
public skill libraries (for example Obra Superpowers and the Vercel Agent Skills Directory) and
have been adapted here. `markitdown` and `rory` build on upstream sources (the MarkItDown
document converter and Rory Sutherland's public talks and writing, respectively). Skills adapted
from a third-party source under a permissive license carry their original copyright and license
text in [`plugins/bitranox/THIRD_PARTY_NOTICES.md`](plugins/bitranox/THIRD_PARTY_NOTICES.md).

## License

MIT - see [`LICENSE`](LICENSE). Adapted third-party skills retain their own permissive licenses;
see [`plugins/bitranox/THIRD_PARTY_NOTICES.md`](plugins/bitranox/THIRD_PARTY_NOTICES.md).
