mdcompose 0.1.3__tar.gz → 0.2.1__tar.gz

mdcompose-0.2.1/.github/FUNDING.yml

@@ -0,0 +1 @@
+ko_fi: rovetown

{mdcompose-0.1.3 → mdcompose-0.2.1}/.github/workflows/ci.yml

@@ -292,27 +292,28 @@ jobs:
             esac
           done
 
-  # DORMANT, repo-gated. The suite (tests/benchmarks) and the `benchmark`
-  # dependency group both exist; what is missing is a CodSpeed project, which
-  # needs the GitHub repo. CodSpeed runs the benchmarks instrumented rather than
-  # wall-clock, so the numbers are stable across runners, and it posts the delta
-  # as a pull request check rather than failing hard. Free for open source. To
-  # enable: connect the repo at codspeed.io, uncomment this job, and leave it
-  # out of the all-green needs list (benchmarks never block a merge).
-  #
-  # benchmarks:
-  #   name: benchmarks
-  #   runs-on: ubuntu-latest
-  #   timeout-minutes: 20
-  #   steps:
-  #     - uses: actions/checkout@v4
-  #       with:
-  #         persist-credentials: false
-  #     - uses: astral-sh/setup-uv@v5
-  #       with:
-  #         enable-cache: true
-  #         cache-dependency-glob: uv.lock
-  #     - run: uv sync --locked --group benchmark
-  #     - uses: CodSpeedHQ/action@v3
-  #       with:
-  #         run: uv run --no-sync pytest tests/benchmarks --codspeed
+  # CodSpeed runs the benchmarks instrumented rather than wall-clock, so the
+  # numbers are stable across runners, and it posts the delta as a pull request
+  # check rather than failing hard. Free for open source. Not in the all-green
+  # needs list: benchmarks never block a merge. Needs the repo connected at
+  # codspeed.io once before its first run.
+  benchmarks:
+    name: benchmarks
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    permissions:
+      contents: read
+      id-token: write # OpenID Connect authentication with CodSpeed
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+      - run: uv sync --locked --group benchmark
+      - uses: CodSpeedHQ/action@373d6868929f444bc08d901fd0eb0ad52a8875ea # v5.2.1
+        with:
+          run: uv run --no-sync pytest tests/benchmarks --codspeed
+          mode: "simulation"

{mdcompose-0.1.3 → mdcompose-0.2.1}/.github/workflows/supply-chain.yml

@@ -85,7 +85,7 @@ jobs:
         with:
           persist-credentials: false
 
-      - uses: google/osv-scanner-action/osv-scanner-action@6e4298ebc4db23e847df9b2e2de2939d6f066c67 # v2.5.1
+      - uses: google/osv-scanner-action/osv-scanner-action@a345acffa64b0eaede81a3d9aae6141214d9c8fc # v2.6.0
         with:
           scan-args: >-
             --lockfile=uv.lock

{mdcompose-0.1.3 → mdcompose-0.2.1}/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to mdcompose are recorded here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v0.2.1 (2026-09-14)
+
+### Added
+
+- add mdcompose skill command group
+
+## v0.2.0 (2026-09-14)
+
+### Added
+
+- compose agent skills alongside AGENTS.md and CLAUDE.md
+
 ## v0.1.3 (2026-09-11)
 
 ## v0.1.2 (2026-09-11)

{mdcompose-0.1.3 → mdcompose-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mdcompose
-Version: 0.1.3
+Version: 0.2.1
 Summary: Keep CLAUDE.md and AGENTS.md in sync and composed from a personal snippet library, without hand-editing every project
 Project-URL: Homepage, https://github.com/Rovetown/mdcompose
 Project-URL: Repository, https://github.com/Rovetown/mdcompose
@@ -40,15 +40,14 @@ Description-Content-Type: text/markdown
 
 <div align="center">
 
-[![PyPI](https://img.shields.io/pypi/v/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/) [![Python](https://img.shields.io/pypi/pyversions/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/) [![CI](https://img.shields.io/github/actions/workflow/status/Rovetown/mdcompose/ci.yml?branch=main&style=for-the-badge&label=CI)](https://github.com/Rovetown/mdcompose/actions/workflows/ci.yml) [![OpenSSF Scorecard](https://img.shields.io/ossf-scorecard/github.com/Rovetown/mdcompose?style=for-the-badge&label=scorecard)](https://scorecard.dev/viewer/?uri=github.com/Rovetown/mdcompose) [![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](https://github.com/Rovetown/mdcompose/blob/main/LICENSE) [![Downloads](https://img.shields.io/pypi/dm/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/)
+[![PyPI](https://img.shields.io/pypi/v/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/) [![Python](https://img.shields.io/pypi/pyversions/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/) [![CI](https://img.shields.io/github/actions/workflow/status/Rovetown/mdcompose/ci.yml?branch=main&style=for-the-badge&label=CI)](https://github.com/Rovetown/mdcompose/actions/workflows/ci.yml) [![CodSpeed Badge](https://img.shields.io/endpoint?url=https://app.codspeed.io//badge.json&style=for-the-badge)](https://app.codspeed.io//Rovetown/mdcompose?utm_source=badge) [![OpenSSF Scorecard](https://img.shields.io/ossf-scorecard/github.com/Rovetown/mdcompose?style=for-the-badge&label=scorecard)](https://scorecard.dev/viewer/?uri=github.com/Rovetown/mdcompose) [![OpenSSF Best Practices](https://img.shields.io/cii/summary/14614?style=for-the-badge&label=best%20practices)](https://www.bestpractices.dev/projects/14614) [![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](https://github.com/Rovetown/mdcompose/blob/main/LICENSE) [![Downloads](https://img.shields.io/pypi/dm/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/) [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Y8Y31VUCGT)
 
 </div>
 
 Most repositories need the same handful of instructions for AI coding agents: how commits are written, which test command to run, which files not to touch.
 mdcompose keeps those as small snippets in one place and builds each project's `AGENTS.md` and `CLAUDE.md` from the ones you pick, so you stop copying the same paragraphs between repositories.
 
-> `mdcompose` composes Markdown.
-> It is unrelated to Docker Compose; the shared `-compose` suffix is a coincidence.
+> `mdcompose` composes Markdown. It is unrelated to Docker Compose.
 
 ## Highlights
 
@@ -59,8 +58,7 @@ mdcompose keeps those as small snippets in one place and builds each project's `
 - **A committed lockfile.** `mdcompose.lock` embeds each snippet's content, so a clone or fork reproduces the same files with an empty library.
 - **Correct paths on Windows, WSL, and Linux**, including a warning when a managed file sits inside a OneDrive-synced folder.
 - **No install required.** `uvx mdcompose doctor` or `pipx run mdcompose doctor` run the real thing in a throwaway environment -- try it, or use it in a one-off script, without adding anything to your machine.
-- **Skills cost tokens too, and that's next (planned).** Every skill an agent does not need loaded for a project is context spent before it has done any work.
-  A skill file -- frontmatter, a body, sometimes a script -- is already snippet-shaped, so curating which skills a project loads, the same way AGENTS.md and CLAUDE.md are curated today, is the natural next composition target: real token savings, not just tidiness.
+- **Skills cost tokens too, so they're composed the same way.** A second, independent library curates which Claude Code Skills a project loads into `.claude/skills/`, so an agent stops paying context for skills a given project never needed.
   See [docs/concepts.md](https://github.com/Rovetown/mdcompose/blob/main/docs/concepts.md).
 
 It makes no network requests and collects no telemetry.
@@ -89,11 +87,9 @@ uvx mdcompose doctor
 
 The whole flow, start to finish:
 
-<!-- demo GIF: docs/assets/mdcompose-demo.gif -- not yet recorded, see TODO.md. Restore the <img> below once it exists. -->
-
 <div align="center">
 
-*(a short demo recording of `init` and `doctor` goes here -- not yet recorded)*
+<img src="https://raw.githubusercontent.com/Rovetown/mdcompose/main/docs/assets/mdcompose-demo.gif" alt="mdcompose demo: init's interactive picker composing AGENTS.md and CLAUDE.md from selected snippets, then doctor confirming both are clean" width="700">
 
 </div>
 
@@ -149,6 +145,10 @@ mdcompose snippet list         the snippets in your library
 mdcompose snippet edit <id>    open one in your editor
 mdcompose snippet remove <id>  delete one
 mdcompose snippet adopt        save a project's embedded snippets to your library
+mdcompose skill list           the skills in your skill library
+mdcompose skill edit <id>      open one in your editor
+mdcompose skill remove <id>    delete one
+mdcompose skill adopt          save a project's embedded skills to your skill library
 mdcompose import <file>        pull sections out of an existing CLAUDE.md or AGENTS.md
 mdcompose convert <src> <dst>  move content between this project's AGENTS.md and CLAUDE.md
 mdcompose eject                stop managing a directory: remove markers, delete the lock
@@ -220,7 +220,7 @@ A few projects cover the same idea of a personal snippet library composed per pr
 What mdcompose does that they do not: import-versus-copy tied to Claude Code's real `@import`; drift detection by hashing one owned block; a committed lock with embedded content so a fork works without the author's library; and real Windows, WSL, and mounted-drive path correctness.
 It deliberately does no format translation: a target receives Markdown, not Cursor rules or Copilot instructions.
 
-**None of them go past agent instructions -- mdcompose plans to.** A skill file is markdown plus optional scripts, same as a snippet; composing a curated skill selection per project the way AGENTS.md and CLAUDE.md are composed today means an agent stops paying context for skills a given project never needed loaded in the first place.
+**None of them go past agent instructions -- mdcompose does.** A skill file is markdown plus frontmatter, same as a snippet; a curated skill selection is composed per project into `.claude/skills/` the same way AGENTS.md and CLAUDE.md are, so an agent stops paying context for skills a given project never needed loaded in the first place.
 
 See [docs/concepts.md](https://github.com/Rovetown/mdcompose/blob/main/docs/concepts.md) for the fuller case for each point.
 

{mdcompose-0.1.3 → mdcompose-0.2.1}/README.md

@@ -10,15 +10,14 @@
 
 <div align="center">
 
-[![PyPI](https://img.shields.io/pypi/v/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/) [![Python](https://img.shields.io/pypi/pyversions/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/) [![CI](https://img.shields.io/github/actions/workflow/status/Rovetown/mdcompose/ci.yml?branch=main&style=for-the-badge&label=CI)](https://github.com/Rovetown/mdcompose/actions/workflows/ci.yml) [![OpenSSF Scorecard](https://img.shields.io/ossf-scorecard/github.com/Rovetown/mdcompose?style=for-the-badge&label=scorecard)](https://scorecard.dev/viewer/?uri=github.com/Rovetown/mdcompose) [![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](https://github.com/Rovetown/mdcompose/blob/main/LICENSE) [![Downloads](https://img.shields.io/pypi/dm/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/)
+[![PyPI](https://img.shields.io/pypi/v/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/) [![Python](https://img.shields.io/pypi/pyversions/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/) [![CI](https://img.shields.io/github/actions/workflow/status/Rovetown/mdcompose/ci.yml?branch=main&style=for-the-badge&label=CI)](https://github.com/Rovetown/mdcompose/actions/workflows/ci.yml) [![CodSpeed Badge](https://img.shields.io/endpoint?url=https://app.codspeed.io//badge.json&style=for-the-badge)](https://app.codspeed.io//Rovetown/mdcompose?utm_source=badge) [![OpenSSF Scorecard](https://img.shields.io/ossf-scorecard/github.com/Rovetown/mdcompose?style=for-the-badge&label=scorecard)](https://scorecard.dev/viewer/?uri=github.com/Rovetown/mdcompose) [![OpenSSF Best Practices](https://img.shields.io/cii/summary/14614?style=for-the-badge&label=best%20practices)](https://www.bestpractices.dev/projects/14614) [![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](https://github.com/Rovetown/mdcompose/blob/main/LICENSE) [![Downloads](https://img.shields.io/pypi/dm/mdcompose?style=for-the-badge)](https://pypi.org/project/mdcompose/) [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Y8Y31VUCGT)
 
 </div>
 
 Most repositories need the same handful of instructions for AI coding agents: how commits are written, which test command to run, which files not to touch.
 mdcompose keeps those as small snippets in one place and builds each project's `AGENTS.md` and `CLAUDE.md` from the ones you pick, so you stop copying the same paragraphs between repositories.
 
-> `mdcompose` composes Markdown.
-> It is unrelated to Docker Compose; the shared `-compose` suffix is a coincidence.
+> `mdcompose` composes Markdown. It is unrelated to Docker Compose.
 
 ## Highlights
 
@@ -29,8 +28,7 @@ mdcompose keeps those as small snippets in one place and builds each project's `
 - **A committed lockfile.** `mdcompose.lock` embeds each snippet's content, so a clone or fork reproduces the same files with an empty library.
 - **Correct paths on Windows, WSL, and Linux**, including a warning when a managed file sits inside a OneDrive-synced folder.
 - **No install required.** `uvx mdcompose doctor` or `pipx run mdcompose doctor` run the real thing in a throwaway environment -- try it, or use it in a one-off script, without adding anything to your machine.
-- **Skills cost tokens too, and that's next (planned).** Every skill an agent does not need loaded for a project is context spent before it has done any work.
-  A skill file -- frontmatter, a body, sometimes a script -- is already snippet-shaped, so curating which skills a project loads, the same way AGENTS.md and CLAUDE.md are curated today, is the natural next composition target: real token savings, not just tidiness.
+- **Skills cost tokens too, so they're composed the same way.** A second, independent library curates which Claude Code Skills a project loads into `.claude/skills/`, so an agent stops paying context for skills a given project never needed.
   See [docs/concepts.md](https://github.com/Rovetown/mdcompose/blob/main/docs/concepts.md).
 
 It makes no network requests and collects no telemetry.
@@ -59,11 +57,9 @@ uvx mdcompose doctor
 
 The whole flow, start to finish:
 
-<!-- demo GIF: docs/assets/mdcompose-demo.gif -- not yet recorded, see TODO.md. Restore the <img> below once it exists. -->
-
 <div align="center">
 
-*(a short demo recording of `init` and `doctor` goes here -- not yet recorded)*
+<img src="https://raw.githubusercontent.com/Rovetown/mdcompose/main/docs/assets/mdcompose-demo.gif" alt="mdcompose demo: init's interactive picker composing AGENTS.md and CLAUDE.md from selected snippets, then doctor confirming both are clean" width="700">
 
 </div>
 
@@ -119,6 +115,10 @@ mdcompose snippet list         the snippets in your library
 mdcompose snippet edit <id>    open one in your editor
 mdcompose snippet remove <id>  delete one
 mdcompose snippet adopt        save a project's embedded snippets to your library
+mdcompose skill list           the skills in your skill library
+mdcompose skill edit <id>      open one in your editor
+mdcompose skill remove <id>    delete one
+mdcompose skill adopt          save a project's embedded skills to your skill library
 mdcompose import <file>        pull sections out of an existing CLAUDE.md or AGENTS.md
 mdcompose convert <src> <dst>  move content between this project's AGENTS.md and CLAUDE.md
 mdcompose eject                stop managing a directory: remove markers, delete the lock
@@ -190,7 +190,7 @@ A few projects cover the same idea of a personal snippet library composed per pr
 What mdcompose does that they do not: import-versus-copy tied to Claude Code's real `@import`; drift detection by hashing one owned block; a committed lock with embedded content so a fork works without the author's library; and real Windows, WSL, and mounted-drive path correctness.
 It deliberately does no format translation: a target receives Markdown, not Cursor rules or Copilot instructions.
 
-**None of them go past agent instructions -- mdcompose plans to.** A skill file is markdown plus optional scripts, same as a snippet; composing a curated skill selection per project the way AGENTS.md and CLAUDE.md are composed today means an agent stops paying context for skills a given project never needed loaded in the first place.
+**None of them go past agent instructions -- mdcompose does.** A skill file is markdown plus frontmatter, same as a snippet; a curated skill selection is composed per project into `.claude/skills/` the same way AGENTS.md and CLAUDE.md are, so an agent stops paying context for skills a given project never needed loaded in the first place.
 
 See [docs/concepts.md](https://github.com/Rovetown/mdcompose/blob/main/docs/concepts.md) for the fuller case for each point.