phenobarbital/ai-parrot/kb-writer

KB Writer

Knowledge-base files give an existing agent extra reference material at answer time. They live flat under AGENTS_DIR/<agent_name>/kb/ — no subdirectories.

Rules

1. The target agent must already exist — check with

list_existing_agents first; if it doesn't, build the agent (see the agent-builder skill) before writing KB content for it.

1. Filenames must be a single path segment (no /) with a .md or

.txt extension.

1. Write clear, self-contained sections — the retrieval layer chunks

these files, so avoid content that only makes sense with hidden context from earlier in the document.

1. Call write_kb_file(agent_name, filename, content). The response

always reports reload_required: true — tell the user the agent must be reloaded (or restarted) before the new content is used; this skill never triggers a reload itself.

Keep each file focused on one topic — prefer several small, well-titled files over one large dump.