Add README

1 files changed, 25 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e1ad56b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# Skills
+
+A collection of agentic skills, primarily for the [pi](https://pi.dev/) coding agent.
+
+Skills are self-contained capability packages that an agent loads on-demand, providing specialized workflows, setup instructions, helper scripts, and reference documentation.
+
+## Available Skills
+
+| Skill | Description |
+|-------|-------------|
+| [youtube-transcript](youtube-transcript/) | Fetch and save YouTube video transcripts as clean plain text |
+
+## Usage
+
+Install a skill directly from this repo using pi:
+
+```
+pi install skill <github-url>/skill-name
+```
+
+Or manually copy a skill directory into your skills folder — either globally (`~/.pi/agent/skills/`) or into a project-level `.pi/agent/skills/` directory.
+
+## Adding a Skill
+
+Each skill lives in its own directory and must contain a `SKILL.md` file with frontmatter (`name`, `description`) and usage instructions. See the [Agent Skills specification](https://agentskills.io/specification) for details.