mirror of
https://github.com/Dvorinka/Devour.git
synced 2026-06-03 20:13:03 +00:00
Tomas Dvorak
103 lines
2.3 KiB
Markdown
103 lines
2.3 KiB
Markdown
---
|
|
name: devour
|
|
description: >
|
|
Use this skill for Devour CLI workflows: scrape docs, get language docs,
|
|
query local index, ask docs-grounded questions, sync sources, run quality
|
|
triage, and verify live smoke checks. Trigger on: "devour", "docs to ai",
|
|
"scrape docs", "ask docs", "query docs", "sync docs", "quality scan".
|
|
allowed-tools:
|
|
- Read
|
|
- Write
|
|
- Edit
|
|
- Glob
|
|
- Grep
|
|
- Bash
|
|
- WebFetch
|
|
---
|
|
|
|
# Devour Skill
|
|
|
|
Use this skill when a task is explicitly about Devour CLI operations or troubleshooting Devour workflows.
|
|
|
|
## What Devour now supports
|
|
|
|
- `devour init`
|
|
- `devour get`
|
|
- `devour scrape`
|
|
- `devour scrape --sources ...`
|
|
- `devour query`
|
|
- `devour ask`
|
|
- `devour sync`
|
|
- `devour status`
|
|
- `devour push <path>` (local ingest)
|
|
- `devour serve` (local stdio JSON-RPC)
|
|
- `devour auto`
|
|
- `devour verify smoke`
|
|
- `devour quality ...`
|
|
|
|
Remote server/push workflows are experimental.
|
|
|
|
## Fast routing
|
|
|
|
1. User gives URL/source: use `devour scrape`.
|
|
2. User gives language+topic: use `devour get`.
|
|
3. User asks a question: use `devour ask --lang ...`.
|
|
4. User wants local search: use `devour query`.
|
|
5. User wants updates from config: use `devour sync`.
|
|
6. User wants automatic intent routing: use `devour auto`.
|
|
7. User wants confidence check: use `devour verify smoke`.
|
|
|
|
## Reliable workflow
|
|
|
|
```bash
|
|
devour init
|
|
devour get go net/http
|
|
devour query "http client timeout"
|
|
devour ask --lang go "how to parse json"
|
|
devour sync
|
|
devour status
|
|
```
|
|
|
|
## Key behavior notes
|
|
|
|
- `ask` is hybrid local-first with targeted live fallback.
|
|
- `query` is local lexical index; no API key required.
|
|
- `scrape` fails by default when 0 docs are extracted (unless `--allow-empty`).
|
|
- `serve` local mode uses JSON-RPC over stdio.
|
|
|
|
## Supported language aliases
|
|
|
|
- `go`, `golang`
|
|
- `rust`
|
|
- `python`, `py`
|
|
- `java`
|
|
- `spring`
|
|
- `typescript`, `ts`
|
|
- `react`
|
|
- `vue`
|
|
- `nuxt`
|
|
- `docker`
|
|
- `cloudflare`, `cf`
|
|
- `astro`
|
|
- `csharp`, `cs`
|
|
- `kotlin`, `kt`
|
|
- `php`
|
|
- `ruby`, `rb`
|
|
- `elixir`, `ex`
|
|
- `next`, `nextjs`
|
|
- `svelte`
|
|
- `angular`, `ng`
|
|
- `remix`
|
|
- `solid`, `solidjs`
|
|
- `express`, `expressjs`
|
|
|
|
## Response expectations
|
|
|
|
When reporting command results:
|
|
|
|
1. Show exact command(s) run.
|
|
2. Summarize key output.
|
|
3. Show output file locations.
|
|
4. Call out limitations/experimental behavior.
|
|
5. Give the next command to continue.
|