Browse Source

docs: add skill reference tables to preset docs (#690)

List the external/third-party skills referenced in each preset config so
users can see what each preset pulls in. 2-column Skill|Description tables
placed before the config block in preset docs and after it in README.
Michael Henke 1 month ago
parent
commit
5e2ffe5999
3 changed files with 43 additions and 0 deletions
  1. 7 0
      README.md
  2. 30 0
      docs/authors-preset.md
  3. 6 0
      docs/thirty-dollars-preset.md

+ 7 - 0
README.md

@@ -166,6 +166,13 @@ The default generated configuration includes both `openai` and `opencode-go` pre
 }
 ```
 
+## Skill Reference
+
+| Skill | Description |
+| --- | --- |
+| `*` | All installed skills (wildcard) |
+| `simplify` | Code simplification |
+
 ### For Alternative Providers
 
 To use custom providers or a mixed-provider setup, use **[Configuration](docs/configuration.md)** for the full reference. If you want a ready-made starting point, check the **[Author's Preset](docs/authors-preset.md)** and **[$30 Preset](docs/thirty-dollars-preset.md)** - the `$30` preset is the best cheap setup.

+ 30 - 0
docs/authors-preset.md

@@ -4,6 +4,36 @@ This is the exact configuration the author runs day-to-day.
 
 ---
 
+## Skill Reference
+
+Each skill is listed with a short description. The config block above shows which agent uses it. These are the author's own third party skills and are not part of the plugin.
+
+| Skill | Description |
+| --- | --- |
+| `*` (excl. `!make-interfaces-feel-better`) | All installed skills except those explicitly excluded |
+| `better-icons` | Icon design |
+| `ce-brainstorm` | Brainstorming workflow |
+| `codegraph` | (MCP) code graph navigation |
+| `context7` | (MCP) library docs lookup |
+| `crawl4ai` | (MCP) web crawling |
+| `customer-research` | Customer research |
+| `gh_app` | (MCP) GitHub app access |
+| `image` | Image generation/editing |
+| `make-interfaces-feel-better` | UI/UX polish |
+| `marketing-psychology` | Marketing psychology |
+| `motion` | Animation/motion design |
+| `nuxt` | Nuxt framework |
+| `pnpm` | pnpm package manager |
+| `searxng` | (MCP) metasearch engine |
+| `tsdown` | tsdown bundler |
+| `video` | Video generation/editing |
+| `vitest` | Vitest test runner |
+| `vite` | Vite build tool |
+| `vue` | Vue framework |
+| `web-perf` | Web performance optimization |
+| `websearch` | (MCP) web search |
+| `workers-best-practices` | Worker best practices |
+
 ## The Config
 
 ```jsonc

+ 6 - 0
docs/thirty-dollars-preset.md

@@ -6,6 +6,12 @@ It uses Codex Plus for the OpenAI models and GitHub Copilot for the premium desi
 
 ---
 
+## Skill Reference
+
+| Skill | Description |
+| --- | --- |
+| `*` | All installed skills (wildcard) |
+
 ## The Config
 
 ```jsonc