From 2628740b64247664d3c1e42af974827ff3c47d5c Mon Sep 17 00:00:00 2001
From: QuartzLibrary <81446760+QuartzLibrary@users.noreply.github.com>
Date: Sat, 11 Apr 2026 18:22:09 +0100
Subject: [PATCH] Document skill existence

---
 README.md                 | 13 +++++++++++++
 packages/node/README.md   | 13 +++++++++++++
 packages/python/README.md | 21 +++++++++++++++++----
 3 files changed, 43 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index adc07bd..3e66606 100644
--- a/README.md
+++ b/README.md
@@ -87,6 +87,19 @@ schema_analysis file1.json file2.json file3.json
 cat data.json | schema_analysis --format json
 ```
 
+### Agent Skill
+
+An [agent skill](https://agentskills.io/) is included in [`.agents/skills/schema-analysis`](.agents/skills/schema-analysis/SKILL.md),
+compatible with Claude Code, Cursor, GitHub Copilot, and [other agents](https://agentskills.io/specification#supported-products).
+
+Install the skill with:
+
+```bash
+npx skills add QuartzLibrary/schema_analysis
+```
+
+Or copy [`.agents/skills/schema-analysis`](.agents/skills/schema-analysis) into your project's `.agents/skills/` directory.
+
 ### Library Usage
 
 ```rust
diff --git a/packages/node/README.md b/packages/node/README.md
index 8d2de9f..2184218 100644
--- a/packages/node/README.md
+++ b/packages/node/README.md
@@ -84,6 +84,19 @@ schema_analysis file1.json file2.json file3.json
 cat data.json | schema_analysis --format json
 ```
 
+### Agent Skill
+
+An [agent skill](https://agentskills.io/) is included in [`.agents/skills/schema-analysis`](.agents/skills/schema-analysis/SKILL.md),
+compatible with Claude Code, Cursor, GitHub Copilot, and [other agents](https://agentskills.io/specification#supported-products).
+
+Install the skill with:
+
+```bash
+npx skills add QuartzLibrary/schema_analysis
+```
+
+Or copy [`.agents/skills/schema-analysis`](.agents/skills/schema-analysis) into your project's `.agents/skills/` directory.
+
 ### Library Usage
 
 For use as a library, see the [Rust crate](https://crates.io/crates/schema_analysis/) or the [repo](https://github.com/QuartzLibrary/schema_analysis).
diff --git a/packages/python/README.md b/packages/python/README.md
index 8d2de9f..29ee025 100644
--- a/packages/python/README.md
+++ b/packages/python/README.md
@@ -25,18 +25,18 @@ our gymnast friend, serde.
 
 ```bash
 # Run without installing
-npx schema_analysis data.json
-# or
 uvx schema_analysis data.json
 # or
 pipx run schema_analysis data.json
+# or
+npx schema_analysis data.json
 
 # Install
-npm install -g schema_analysis
+uv tool install schema_analysis
 # or
 pip install schema_analysis
 # or
-uv tool install schema_analysis
+npm install -g schema_analysis
 # or
 cargo install schema_analysis --features cli --locked
 ```
@@ -84,6 +84,19 @@ schema_analysis file1.json file2.json file3.json
 cat data.json | schema_analysis --format json
 ```
 
+### Agent Skill
+
+An [agent skill](https://agentskills.io/) is included in [`.agents/skills/schema-analysis`](.agents/skills/schema-analysis/SKILL.md),
+compatible with Claude Code, Cursor, GitHub Copilot, and [other agents](https://agentskills.io/specification#supported-products).
+
+Install the skill with:
+
+```bash
+npx skills add QuartzLibrary/schema_analysis
+```
+
+Or copy [`.agents/skills/schema-analysis`](.agents/skills/schema-analysis) into your project's `.agents/skills/` directory.
+
 ### Library Usage
 
 For use as a library, see the [Rust crate](https://crates.io/crates/schema_analysis/) or the [repo](https://github.com/QuartzLibrary/schema_analysis).