devopsby evolution-foundation
knowledge-admin
evolution-foundation/knowledge-admin
Administrative operations on the Knowledge base: connect new pgvector servers, check health, view stats, export data, install parser models.
What it changes
Passed 19 of 22 test cases with the skill, and 6 of 22 without it.
Without skill27%
With skill86%
Checks it passed that the model alone missed
- Defaults to jsonl format for document export.
- Performs a no-op if models are already installed.
- Expects growth_7d in the stats API response structure.
and 15 more in the full report
13 fixed6 passed either way3 still failing0 broke
- Pass-rate lift
- +59 pp
- Tokens
- +14%
- Agent turns
- 0%
- Response time
- -56%
Model gemini-3.6-flashMeasured 8/19/2026v119 of 22 cases passed with skill
See it in action
One of 13 test cases the skill fixed. Same model, same prompt, with and without the skill.
PromptWhat default document export format is used when exporting a space without specifying a format parameter?
What was checked, without and with the skill| Checked | Without skill | With skill |
|---|
| Defaults to jsonl format for document export. | Missed | Passed |
|---|
What's inside
The instructions your model reads when the skill loads.
SKILL.md136 linessingle file
knowledge-admin
Group: Administration. Consolidates connect/health/stats/export/install-parser via subcommand.
When to trigger
- "Connect a new pgvector"
- "Status of connections"
- "How many docs are in Academy?"
- "Export space X as backup"
- "Install Marker models"
Arguments
Actions
connect — New connection wizard
Optional args: slug, name, host, port, database, username, password, ssl_mode, connection_string.
Flow:
- If args missing, ask interactively (chat):
- Name ("What do you want to call this connection?")
- Host, port (default 5432), user, password, database, SSL mode
- OR paste a full connection string
POST /api/knowledge/connections — register (encryption via workspace key)POST /api/knowledge/connections/:id/configure — runs:
SELECT version() (Postgres >= 14)- Validate
pgvector >= 0.5
- PgBouncer detect (port 6543, pooler, ?pgbouncer=true) → HTTP 422 with message
- Alembic upgrade head
- Seed
knowledge_config
- Show phase-by-phase progress
- Output: final status + next steps ("create your first space via UI or
knowledge-organize action=create")
Track record
Benchmark
19 / 22
test cases passed, vs 6 / 22 without
Adoption
- Users
- 0
- Times used
- 0
Safety and source details
SkillSafety
✓ 3 of 3 passed✓Code scan15 of 15 checks clean
0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026
View 15 scanner checks
live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing
✓IntentSafe
LLM judge · does the skill do what it claims
✓ContentClean
LLM judge · policy & harmful-content review
Source
Importedevolution-foundation / evo-nexus
.claude/skills/knowledge-admin/SKILL.md
License NOASSERTIONImported 8/3/2026Version v1