From be978124b80dc6b60586773e1d125d1cdf36d26a Mon Sep 17 00:00:00 2001
From: Steph Ango <10565871+kepano@users.noreply.github.com>
Date: Tue, 10 Feb 2026 15:31:59 -0800
Subject: [PATCH] Add skill descriptions

---
 README.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 4ca6a3e..6141834 100644
--- a/README.md
+++ b/README.md
@@ -23,8 +23,10 @@ Copy the `skills/` directory into your Codex skills path (typically `~/.codex/sk
 
 ## Skills
 
-### Create and edit Obsidian-compatible plain text files
-
-- [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown) `.md`
-- [Obsidian Bases](https://help.obsidian.md/bases/syntax) `.base`
-- [JSON Canvas](https://jsoncanvas.org/) `.canvas`
+| Skill | Description |
+|-------|-------------|
+| [obsidian-markdown](skills/obsidian-markdown) | Create and edit [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown) (`.md`) with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax |
+| [obsidian-bases](skills/obsidian-bases) | Create and edit [Obsidian Bases](https://help.obsidian.md/bases/syntax) (`.base`) with views, filters, formulas, and summaries |
+| [json-canvas](skills/json-canvas) | Create and edit [JSON Canvas](https://jsoncanvas.org/) files (`.canvas`) with nodes, edges, groups, and connections |
+| [obsidian-cli](skills/obsidian-cli) | Interact with Obsidian vaults via the [Obsidian CLI](https://help.obsidian.md/cli) including plugin and theme development |
+| [defuddle](skills/defuddle) | Extract clean markdown from web pages using [Defuddle](https://github.com/kepano/defuddle-cli), removing clutter to save tokens |