skillsinc 0.1.0__tar.gz

skillsinc-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mike Hill
+
+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.

skillsinc-0.1.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: skillsinc
+Version: 0.1.0
+Summary: Sync one library of agent skills, instructions, agents, and prompts into every AI coding harness you use.
+Keywords: agents,skills,claude-code,codex,copilot,sync
+Author: Mike Hill
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Typing :: Typed
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: tomlkit>=0.13.3
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/mikejhill/skillsinc
+Project-URL: Issues, https://github.com/mikejhill/skillsinc/issues
+Project-URL: Changelog, https://github.com/mikejhill/skillsinc/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# SkillSinc
+
+[![CI](https://github.com/mikejhill/skillsinc/actions/workflows/ci.yml/badge.svg)](https://github.com/mikejhill/skillsinc/actions/workflows/ci.yml)
+[![Release](https://github.com/mikejhill/skillsinc/actions/workflows/release.yml/badge.svg)](https://github.com/mikejhill/skillsinc/actions/workflows/release.yml)
+[![License](https://img.shields.io/github/license/mikejhill/skillsinc)](LICENSE)
+
+Write your agent skills, instructions, agents, prompts, MCP servers, reference files, and hooks once. SkillSinc copies them into Claude Code, GitHub Copilot, VS Code, Codex, and the shared `~/.agents` folder, converting formats where it must and saying so when a conversion loses something.
+
+It replaces hand-copying, symlinks, and per-tool sync scripts with one command that shows you every change before it makes it.
+
+## How it works
+
+```mermaid
+graph LR
+    Library[Your library<br/>skills/ instructions/ agents/ prompts/] --> Plan[skillsinc plan]
+    Plan --> Claude[~/.claude]
+    Plan --> Copilot[~/.copilot]
+    Plan --> VSCode[VS Code prompts]
+    Plan --> Codex[~/.codex/AGENTS.md]
+    Plan --> Agents[~/.agents/skills]
+```
+
+- **Your library is the source of truth.** A sync makes each destination match it: new items are added, changed items updated, removed items deleted.
+- **SkillSinc only touches what it wrote.** It records every file it owns. An existing file it did not write blocks that destination until you review it and pass `--adopt`.
+- **Nothing is written without a plan.** `skillsinc plan` lists every change; `skillsinc sync` applies the same plan.
+- **Lossy conversions are opt-in.** If a harness cannot represent a field (for example, Claude ignores Copilot `tools` lists), the item is skipped until the route sets `allow_lossy = true`.
+- **A broken source never deletes anything.** If a library cannot be read completely, its destinations are left untouched.
+
+## Install
+
+Requires Python 3.12+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv tool install git+https://github.com/mikejhill/skillsinc.git
+```
+
+## Quick start
+
+1. Write a configuration. It enables a destination for every harness folder found on this machine and creates an empty library at `~/.config/skillsinc/library` (`$XDG_CONFIG_HOME/skillsinc/library`). Pass `--source DIR` to use an existing library instead:
+
+    ```bash
+    skillsinc init
+    ```
+
+2. Preview the changes:
+
+    ```bash
+    skillsinc plan
+    ```
+
+3. Apply them:
+
+    ```bash
+    skillsinc sync
+    ```
+
+Run `skillsinc sync` again whenever the library changes, or schedule it with Task Scheduler, launchd, or a systemd timer using the [scheduling examples](docs/guides/scheduling.md). An overlapping run exits without writing.
+
+## Library layout
+
+The layout matches GitHub Copilot's file conventions, so an existing Copilot library works unchanged:
+
+```text
+my-agent-library/
+├── skills/<name>/SKILL.md            # plus any supporting files
+├── instructions/<name>.instructions.md
+├── agents/<name>.agent.md
+├── prompts/<name>.prompt.md
+├── mcp/<name>.json                   # one MCP server definition per file
+├── resources/<name>.md               # reference files, copied as written
+├── hooks/<name>.json                 # one Copilot CLI hook file per file
+└── plugins/<plugin>/                 # Claude Code plugin layout, expanded into the kinds above
+```
+
+`INTENT.md`, `*.intent.md`, and hidden files are never distributed. A plugin's `skills/`, `agents/`, `commands/`, and `.mcp.json` are synced as skills, agents, prompts, and MCP servers; everything else in it (hooks, scripts, LSP servers) is reported as a loss. See [decision 0005](docs/decisions/0005-plugins-expand-into-kinds.md).
+
+## What each harness receives
+
+| Profile   | Skills    | Instructions                 | Agents               | Prompts              | MCP servers                    | Resources                             | Hooks                   |
+| --------- | --------- | ---------------------------- | -------------------- | -------------------- | ------------------------------ | ------------------------------------- | ----------------------- |
+| `claude`  | `skills/` | `rules/<name>.md` (`paths`)  | `agents/<name>.md`   | `commands/<name>.md` | `~/.claude.json` `mcpServers`  | `resources/` + `CLAUDE.md` `@` import | `settings.json` `hooks` |
+| `copilot` | `skills/` | `instructions/`              | `agents/`            | —                    | `mcp-config.json` `mcpServers` | `resources/`                          | `hooks/`                |
+| `vscode`  | —         | `<name>.instructions.md`     | `<name>.agent.md`    | `<name>.prompt.md`   | `User/mcp.json` `servers`      | —                                     | —                       |
+| `codex`   | —         | managed block in `AGENTS.md` | `agents/<name>.toml` | —                    | —                              | —                                     | —                       |
+| `agents`  | `skills/` | —                            | —                    | —                    | —                              | —                                     | —                       |
+| `generic` | verbatim  | verbatim                     | verbatim             | verbatim             | verbatim                       | verbatim                              | verbatim                |
+
+Run `skillsinc profiles` for the same table. See [harness profiles](docs/guides/harness-profiles.md) for exact conversions.
+
+## Commands
+
+| Command              | Purpose                                            |
+| -------------------- | -------------------------------------------------- |
+| `skillsinc init`     | Write a starter configuration                      |
+| `skillsinc plan`     | Show every change a sync would make; write nothing |
+| `skillsinc sync`     | Apply the plan                                     |
+| `skillsinc profiles` | List harness profiles and what each kind becomes   |
+
+`plan` and `sync` accept `--destination NAME` (repeatable), `--adopt`, `--json`, `--verbose`, and `--config PATH`. Exit codes: `0` success, `1` a destination was blocked or failed, `2` configuration or usage error, `130` interrupted.
+
+## Documentation
+
+- [Configuration reference](docs/guides/configuration.md)
+- [Command-line reference](docs/guides/command-line.md)
+- [Scheduling](docs/guides/scheduling.md)
+- [Development guide](docs/guides/development.md)
+- [Roadmap](docs/planning/roadmap.md)
+- [Harness profiles](docs/guides/harness-profiles.md)
+- [Philosophy and goals](docs/architecture/philosophy.md)
+- [Architecture](docs/architecture/overview.md)
+- [Decision: rebuild scope](docs/decisions/0001-rebuild-scope.md)
+- [Decision: MCP server entries](docs/decisions/0002-mcp-server-entries.md)
+- [Decision: resources and Claude imports](docs/decisions/0003-resources-and-claude-imports.md)
+- [Decision: TOML entries with tomlkit](docs/decisions/0004-toml-entries-with-tomlkit.md)
+- [Decision: plugins expand into kinds](docs/decisions/0005-plugins-expand-into-kinds.md)
+- [Decision: entry files beside a destination root](docs/decisions/0007-files-beside-the-root.md)
+- [Decision: edit VS Code's JSONC mcp.json in place](docs/decisions/0008-jsonc-edits-in-place.md)
+- [Decision: one copy of each item per harness](docs/decisions/0009-one-copy-per-harness.md)
+- [Decision: MCP server options and per-profile overrides](docs/decisions/0010-mcp-server-options.md)
+- [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [Changelog](CHANGELOG.md)
+
+## License
+
+[MIT](LICENSE)

skillsinc-0.1.0/README.md

@@ -0,0 +1,124 @@
+# SkillSinc
+
+[![CI](https://github.com/mikejhill/skillsinc/actions/workflows/ci.yml/badge.svg)](https://github.com/mikejhill/skillsinc/actions/workflows/ci.yml)
+[![Release](https://github.com/mikejhill/skillsinc/actions/workflows/release.yml/badge.svg)](https://github.com/mikejhill/skillsinc/actions/workflows/release.yml)
+[![License](https://img.shields.io/github/license/mikejhill/skillsinc)](LICENSE)
+
+Write your agent skills, instructions, agents, prompts, MCP servers, reference files, and hooks once. SkillSinc copies them into Claude Code, GitHub Copilot, VS Code, Codex, and the shared `~/.agents` folder, converting formats where it must and saying so when a conversion loses something.
+
+It replaces hand-copying, symlinks, and per-tool sync scripts with one command that shows you every change before it makes it.
+
+## How it works
+
+```mermaid
+graph LR
+    Library[Your library<br/>skills/ instructions/ agents/ prompts/] --> Plan[skillsinc plan]
+    Plan --> Claude[~/.claude]
+    Plan --> Copilot[~/.copilot]
+    Plan --> VSCode[VS Code prompts]
+    Plan --> Codex[~/.codex/AGENTS.md]
+    Plan --> Agents[~/.agents/skills]
+```
+
+- **Your library is the source of truth.** A sync makes each destination match it: new items are added, changed items updated, removed items deleted.
+- **SkillSinc only touches what it wrote.** It records every file it owns. An existing file it did not write blocks that destination until you review it and pass `--adopt`.
+- **Nothing is written without a plan.** `skillsinc plan` lists every change; `skillsinc sync` applies the same plan.
+- **Lossy conversions are opt-in.** If a harness cannot represent a field (for example, Claude ignores Copilot `tools` lists), the item is skipped until the route sets `allow_lossy = true`.
+- **A broken source never deletes anything.** If a library cannot be read completely, its destinations are left untouched.
+
+## Install
+
+Requires Python 3.12+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv tool install git+https://github.com/mikejhill/skillsinc.git
+```
+
+## Quick start
+
+1. Write a configuration. It enables a destination for every harness folder found on this machine and creates an empty library at `~/.config/skillsinc/library` (`$XDG_CONFIG_HOME/skillsinc/library`). Pass `--source DIR` to use an existing library instead:
+
+    ```bash
+    skillsinc init
+    ```
+
+2. Preview the changes:
+
+    ```bash
+    skillsinc plan
+    ```
+
+3. Apply them:
+
+    ```bash
+    skillsinc sync
+    ```
+
+Run `skillsinc sync` again whenever the library changes, or schedule it with Task Scheduler, launchd, or a systemd timer using the [scheduling examples](docs/guides/scheduling.md). An overlapping run exits without writing.
+
+## Library layout
+
+The layout matches GitHub Copilot's file conventions, so an existing Copilot library works unchanged:
+
+```text
+my-agent-library/
+├── skills/<name>/SKILL.md            # plus any supporting files
+├── instructions/<name>.instructions.md
+├── agents/<name>.agent.md
+├── prompts/<name>.prompt.md
+├── mcp/<name>.json                   # one MCP server definition per file
+├── resources/<name>.md               # reference files, copied as written
+├── hooks/<name>.json                 # one Copilot CLI hook file per file
+└── plugins/<plugin>/                 # Claude Code plugin layout, expanded into the kinds above
+```
+
+`INTENT.md`, `*.intent.md`, and hidden files are never distributed. A plugin's `skills/`, `agents/`, `commands/`, and `.mcp.json` are synced as skills, agents, prompts, and MCP servers; everything else in it (hooks, scripts, LSP servers) is reported as a loss. See [decision 0005](docs/decisions/0005-plugins-expand-into-kinds.md).
+
+## What each harness receives
+
+| Profile   | Skills    | Instructions                 | Agents               | Prompts              | MCP servers                    | Resources                             | Hooks                   |
+| --------- | --------- | ---------------------------- | -------------------- | -------------------- | ------------------------------ | ------------------------------------- | ----------------------- |
+| `claude`  | `skills/` | `rules/<name>.md` (`paths`)  | `agents/<name>.md`   | `commands/<name>.md` | `~/.claude.json` `mcpServers`  | `resources/` + `CLAUDE.md` `@` import | `settings.json` `hooks` |
+| `copilot` | `skills/` | `instructions/`              | `agents/`            | —                    | `mcp-config.json` `mcpServers` | `resources/`                          | `hooks/`                |
+| `vscode`  | —         | `<name>.instructions.md`     | `<name>.agent.md`    | `<name>.prompt.md`   | `User/mcp.json` `servers`      | —                                     | —                       |
+| `codex`   | —         | managed block in `AGENTS.md` | `agents/<name>.toml` | —                    | —                              | —                                     | —                       |
+| `agents`  | `skills/` | —                            | —                    | —                    | —                              | —                                     | —                       |
+| `generic` | verbatim  | verbatim                     | verbatim             | verbatim             | verbatim                       | verbatim                              | verbatim                |
+
+Run `skillsinc profiles` for the same table. See [harness profiles](docs/guides/harness-profiles.md) for exact conversions.
+
+## Commands
+
+| Command              | Purpose                                            |
+| -------------------- | -------------------------------------------------- |
+| `skillsinc init`     | Write a starter configuration                      |
+| `skillsinc plan`     | Show every change a sync would make; write nothing |
+| `skillsinc sync`     | Apply the plan                                     |
+| `skillsinc profiles` | List harness profiles and what each kind becomes   |
+
+`plan` and `sync` accept `--destination NAME` (repeatable), `--adopt`, `--json`, `--verbose`, and `--config PATH`. Exit codes: `0` success, `1` a destination was blocked or failed, `2` configuration or usage error, `130` interrupted.
+
+## Documentation
+
+- [Configuration reference](docs/guides/configuration.md)
+- [Command-line reference](docs/guides/command-line.md)
+- [Scheduling](docs/guides/scheduling.md)
+- [Development guide](docs/guides/development.md)
+- [Roadmap](docs/planning/roadmap.md)
+- [Harness profiles](docs/guides/harness-profiles.md)
+- [Philosophy and goals](docs/architecture/philosophy.md)
+- [Architecture](docs/architecture/overview.md)
+- [Decision: rebuild scope](docs/decisions/0001-rebuild-scope.md)
+- [Decision: MCP server entries](docs/decisions/0002-mcp-server-entries.md)
+- [Decision: resources and Claude imports](docs/decisions/0003-resources-and-claude-imports.md)
+- [Decision: TOML entries with tomlkit](docs/decisions/0004-toml-entries-with-tomlkit.md)
+- [Decision: plugins expand into kinds](docs/decisions/0005-plugins-expand-into-kinds.md)
+- [Decision: entry files beside a destination root](docs/decisions/0007-files-beside-the-root.md)
+- [Decision: edit VS Code's JSONC mcp.json in place](docs/decisions/0008-jsonc-edits-in-place.md)
+- [Decision: one copy of each item per harness](docs/decisions/0009-one-copy-per-harness.md)
+- [Decision: MCP server options and per-profile overrides](docs/decisions/0010-mcp-server-options.md)
+- [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [Changelog](CHANGELOG.md)
+
+## License
+
+[MIT](LICENSE)

skillsinc-0.1.0/pyproject.toml

@@ -0,0 +1,232 @@
+[project]
+name = "skillsinc"
+version = "0.1.0"
+description = "Sync one library of agent skills, instructions, agents, and prompts into every AI coding harness you use."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+keywords = [
+    "agents",
+    "skills",
+    "claude-code",
+    "codex",
+    "copilot",
+    "sync",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development",
+    "Typing :: Typed",
+]
+dependencies = [
+    "pyyaml>=6.0.3",
+    "tomlkit>=0.13.3",
+]
+
+[[project.authors]]
+name = "Mike Hill"
+
+[project.urls]
+Homepage = "https://github.com/mikejhill/skillsinc"
+Issues = "https://github.com/mikejhill/skillsinc/issues"
+Changelog = "https://github.com/mikejhill/skillsinc/blob/main/CHANGELOG.md"
+
+[project.scripts]
+skillsinc = "skillsinc.__main__:Application.main"
+
+[build-system]
+requires = ["uv_build>=0.11.32,<0.12.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "hypothesis>=6.169.2",
+    "poethepoet>=0.48.0",
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+    "pytest-randomly>=5.0.0",
+    "ruff>=0.17.0",
+    "ty>=0.0.86",
+    "types-pyyaml>=6.0.12.20260906",
+]
+mutation = ["mutmut>=3.8.0"]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+src = [
+    "src",
+    "tests",
+]
+
+[tool.ruff.lint]
+select = [
+    "A",
+    "ANN",
+    "ARG",
+    "B",
+    "BLE",
+    "C4",
+    "C90",
+    "D",
+    "DTZ",
+    "E",
+    "ERA",
+    "F",
+    "FA",
+    "FBT",
+    "G",
+    "I",
+    "LOG",
+    "N",
+    "PERF",
+    "PGH",
+    "PIE",
+    "PL",
+    "PT",
+    "PTH",
+    "RET",
+    "RSE",
+    "RUF",
+    "S",
+    "SIM",
+    "T20",
+    "TID",
+    "TRY",
+    "UP",
+    "W",
+]
+ignore = [
+    "D107",
+    "TRY003",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "S101",
+    "PLR2004",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.mccabe]
+max-complexity = 10
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ty.rules]
+all = "error"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "-ra",
+    "--import-mode=importlib",
+    "-m",
+    "not perf",
+]
+xfail_strict = true
+markers = [
+    "unit: one module through its public API (the default layer)",
+    "integration: user journeys through Application.run in one process",
+    "e2e: the skillsinc process run against a throwaway home directory",
+    "perf: time budgets for planning and syncing large libraries",
+]
+
+[tool.coverage.run]
+source = ["skillsinc"]
+branch = true
+
+[tool.coverage.report]
+fail_under = 98
+show_missing = true
+skip_covered = true
+exclude_also = [
+    "if __name__ == .__main__.:",
+    'assert_never\(',
+]
+
+[tool.poe.tasks.format]
+cmd = "ruff format ."
+help = "Format code"
+
+[tool.poe.tasks.format-check]
+cmd = "ruff format --check ."
+help = "Check formatting"
+
+[tool.poe.tasks.lint]
+cmd = "ruff check ."
+help = "Lint code"
+
+[tool.poe.tasks.lint-fix]
+cmd = "ruff check . --fix"
+help = "Lint and auto-fix"
+
+[tool.poe.tasks.typecheck]
+cmd = "ty check"
+help = "Type check (strict)"
+
+[tool.poe.tasks.test]
+cmd = "pytest --cov"
+help = "Run unit, property, integration, and e2e tests with coverage"
+
+[tool.poe.tasks.e2e]
+cmd = "pytest -m e2e"
+help = "Run the skillsinc process against a throwaway home"
+
+[tool.poe.tasks.perf]
+cmd = "pytest -m perf --durations=0 -p no:randomly"
+help = "Run the performance budgets"
+
+[tool.poe.tasks.mutate]
+shell = "uv run --group mutation mutmut run && uv run --group mutation mutmut results --all true > mutation-results.txt && uv run python scripts/mutation_report.py mutation-results.txt"
+help = "Mutation testing (POSIX only; slow)"
+
+[tool.poe.tasks.docs-lint]
+cmd = "npx --yes markdownlint-cli2"
+help = "Lint Markdown documentation"
+
+[tool.poe.tasks.fix]
+sequence = [
+    "format",
+    "lint-fix",
+]
+help = "Auto-fix formatting and lint"
+
+[tool.poe.tasks.check]
+sequence = [
+    "format-check",
+    "lint",
+    "typecheck",
+    "test",
+]
+help = "Run every Python quality gate"
+
+[tool.mutmut]
+source_paths = ["src/skillsinc/"]
+pytest_add_cli_args_test_selection = ["tests/"]
+pytest_add_cli_args = [
+    "-p",
+    "no:randomly",
+    "-p",
+    "no:cacheprovider",
+    "-m",
+    "not e2e and not perf",
+]
+mutate_only_covered_lines = true
+also_copy = ["examples/"]

skillsinc-0.1.0/pyproject.toml.orig

@@ -0,0 +1,140 @@
+[project]
+name = "skillsinc"
+version = "0.1.0"
+description = "Sync one library of agent skills, instructions, agents, and prompts into every AI coding harness you use."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Mike Hill" }]
+requires-python = ">=3.12"
+keywords = ["agents", "skills", "claude-code", "codex", "copilot", "sync"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development",
+    "Typing :: Typed",
+]
+dependencies = [
+    "pyyaml>=6.0.3",
+    "tomlkit>=0.13.3",
+]
+
+[project.urls]
+Homepage = "https://github.com/mikejhill/skillsinc"
+Issues = "https://github.com/mikejhill/skillsinc/issues"
+Changelog = "https://github.com/mikejhill/skillsinc/blob/main/CHANGELOG.md"
+
+[project.scripts]
+skillsinc = "skillsinc.__main__:Application.main"
+
+[build-system]
+requires = ["uv_build>=0.11.32,<0.12.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "hypothesis>=6.169.2",
+    "poethepoet>=0.48.0",
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+    "pytest-randomly>=5.0.0",
+    "ruff>=0.17.0",
+    "ty>=0.0.86",
+    "types-pyyaml>=6.0.12.20260906",
+]
+mutation = [
+    "mutmut>=3.8.0",
+]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "A", "ANN", "ARG", "B", "BLE", "C4", "C90", "D", "DTZ", "E", "ERA", "F",
+    "FA", "FBT", "G", "I", "LOG", "N", "PERF", "PGH", "PIE", "PL", "PT", "PTH",
+    "RET", "RSE", "RUF", "S", "SIM", "T20", "TID", "TRY", "UP", "W",
+]
+ignore = [
+    "D107",    # __init__ docstring: the class docstring covers it
+    "TRY003",  # long messages in raise: context-rich messages are required here
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "S101",     # assert is how pytest works
+    "PLR2004",  # literal expected values are clearer in tests
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.mccabe]
+max-complexity = 10
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ty.rules]
+all = "error"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = [
+    "--strict-markers", "--strict-config", "-ra", "--import-mode=importlib",
+    # Performance budgets run in their own job: `poe perf`
+    "-m", "not perf",
+]
+xfail_strict = true
+markers = [
+    "unit: one module through its public API (the default layer)",
+    "integration: user journeys through Application.run in one process",
+    "e2e: the skillsinc process run against a throwaway home directory",
+    "perf: time budgets for planning and syncing large libraries",
+]
+
+[tool.coverage.run]
+source = ["skillsinc"]
+branch = true
+
+[tool.coverage.report]
+fail_under = 98
+show_missing = true
+skip_covered = true
+exclude_also = ['if __name__ == .__main__.:', 'assert_never\(']
+
+[tool.poe.tasks]
+format = { cmd = "ruff format .", help = "Format code" }
+format-check = { cmd = "ruff format --check .", help = "Check formatting" }
+lint = { cmd = "ruff check .", help = "Lint code" }
+lint-fix = { cmd = "ruff check . --fix", help = "Lint and auto-fix" }
+typecheck = { cmd = "ty check", help = "Type check (strict)" }
+test = { cmd = "pytest --cov", help = "Run unit, property, integration, and e2e tests with coverage" }
+e2e = { cmd = "pytest -m e2e", help = "Run the skillsinc process against a throwaway home" }
+perf = { cmd = "pytest -m perf --durations=0 -p no:randomly", help = "Run the performance budgets" }
+mutate = { shell = "uv run --group mutation mutmut run && uv run --group mutation mutmut results --all true > mutation-results.txt && uv run python scripts/mutation_report.py mutation-results.txt", help = "Mutation testing (POSIX only; slow)" }
+docs-lint = { cmd = "npx --yes markdownlint-cli2", help = "Lint Markdown documentation" }
+fix = { sequence = ["format", "lint-fix"], help = "Auto-fix formatting and lint" }
+check = { sequence = ["format-check", "lint", "typecheck", "test"], help = "Run every Python quality gate" }
+
+[tool.mutmut]
+# Mutation testing: change the code in small ways and check a test fails.
+# POSIX only (it forks); run it on Linux, macOS, or WSL with `uv run poe mutate`.
+source_paths = ["src/skillsinc/"]
+pytest_add_cli_args_test_selection = ["tests/"]
+# Process tests and timing budgets run the installed code, not the mutant
+pytest_add_cli_args = ["-p", "no:randomly", "-p", "no:cacheprovider", "-m", "not e2e and not perf"]
+mutate_only_covered_lines = true
+# Files tests read beside the code
+also_copy = ["examples/"]

skillsinc-0.1.0/src/skillsinc/__init__.py

@@ -0,0 +1,3 @@
+"""SkillSinc: sync one library of agent customizations into every AI harness."""
+
+from __future__ import annotations