airweave

Files (41)

• SKILL.md
• overview.md · references/
• repo-provenance.md · references/
• repo-routing-metadata.json · references/
• troubleshooting.md · references/
• check_env.py · scripts/
• SKILL.md · sub-skills/backend-api/
• api-reference.md · sub-skills/backend-api/references/
• troubleshooting.md · sub-skills/backend-api/references/
• workflows.md · sub-skills/backend-api/references/
• agentic_search_stream.py · sub-skills/backend-api/scripts/
• SKILL.md · sub-skills/connect-widget/
• messaging-contract.md · sub-skills/connect-widget/references/
• oauth-and-modes.md · sub-skills/connect-widget/references/
• troubleshooting.md · sub-skills/connect-widget/references/
• widget-overview.md · sub-skills/connect-widget/references/
• SKILL.md · sub-skills/frontend-dashboard/
• api-client.md · sub-skills/frontend-dashboard/references/
• collections-and-orgs.md · sub-skills/frontend-dashboard/references/
• search-ui.md · sub-skills/frontend-dashboard/references/
• troubleshooting.md · sub-skills/frontend-dashboard/references/
• SKILL.md · sub-skills/local-development/
• local-stack.md · sub-skills/local-development/references/
• troubleshooting.md · sub-skills/local-development/references/
• local-stack.sh · sub-skills/local-development/scripts/
• SKILL.md · sub-skills/mcp-search/
• auth-and-troubleshooting.md · sub-skills/mcp-search/references/
• mcp-overview.md · sub-skills/mcp-search/references/
• transport-and-tools.md · sub-skills/mcp-search/references/
• mcp-smoke.sh · sub-skills/mcp-search/scripts/
• SKILL.md · sub-skills/monke-e2e/
• config-and-auth.md · sub-skills/monke-e2e/references/
• connector-registry.md · sub-skills/monke-e2e/references/
• overview.md · sub-skills/monke-e2e/references/
• troubleshooting.md · sub-skills/monke-e2e/references/
• monke-list-connectors.sh · sub-skills/monke-e2e/scripts/
• SKILL.md · sub-skills/source-connectors/
• auth-and-config.md · sub-skills/source-connectors/references/
• browse-tree.md · sub-skills/source-connectors/references/
• source-registry.md · sub-skills/source-connectors/references/
• troubleshooting.md · sub-skills/source-connectors/references/

SKILL.md (first lines)

# Airweave

Use this skill when a task is about the Airweave repository itself. It is a router, not a monolith: pick the narrowest sub-skill that matches the request, then cross-link to the others only when the task spans multiple surfaces.

Start with `scripts/check_env.py` when you need a quick repo sanity check.

## Sub-skill map

| Task family | Use | Notes |
| --- | --- | --- |
| Local Docker stack, env seeding, ports, start/restart/recreate/destroy | `sub-skills/local-development/SKILL.md` | Safe stack orchestration and health checks |
| Search, collections, source connections, webhooks, usage, browse-tree routes | `sub-skills/backend-api/SKILL.md` | API shapes, request/response contracts, stream debugging |
| Source classes, registry metadata, auth/config, browse-tree implementation, ACLs | `sub-skills/source-connectors/SKILL.md` | Connector internals only |
| Dashboard UI, auth context, collections pages, search UI, billing/admin | `sub-skills/frontend-dashboard/SKILL.md` | React/Vite client behavior |
| Connect iframe, postMessage, OAuth popup, session modes | `sub-skills/connect-widget/SKILL.md` | Widget and parent messaging only |
| MCP server, tool registration, stdio/HTTP transport, auth modes | `sub-skills/mcp-search/SKILL.md` | Streamable HTTP and CLI diagnostics |
| Monke connector discovery, configs, runner, credential resolution | `sub-skills/monke-e2e/SKILL.md` | Safe discovery helper; no credentialed test runs by default |

## Operating rules

- Prefer the narrowest sub-skill that matches the task.
- When a task spans multiple surfaces, start with the dominant one and cross-link the others.
- Keep runtime guidance inside the generated skill tree.
- Do not depend on the original checkout path when a bundled helper exists.

## Useful references

- `references/overview.md` for the repo map and package layout
- `references/troubleshooting.md` for cross-cutting failures
- `references/repo-provenance.md` for the source snapshot used to build this skill tree
- `references/repo-routing-metadata.json` for repo-skills-router placement

From VectorSpaceLab/AREX-Skill, MIT.

More from VectorSpaceLab/AREX-Skill