knw

name	knw
description	Save and recall useful facts. Use when information should be remembered for later or relevant saved knowledge may help answer a request.

knw

Use the bundled Python CLI to access the knw facts retrieval service. The service matches saved facts against a search query, so both facts and queries should carry enough context to stand on their own.

Write Good Facts

Store atomic, self-contained facts. Each fact should express one useful idea and remain understandable without the surrounding conversation.

• Include the subject explicitly instead of relying on pronouns or implied context.
• Split unrelated details into separate facts.
• Preserve qualifiers that affect meaning, such as environment, project, person, or date.

Prefer "The knw service is deployed in the eu-west-1 region." over "It is in eu-west-1."

Search With Context

Use search before answering when saved knowledge may be relevant. Include the relevant context from the user's request in the query so it can align well with self-contained facts. Do not search with vague fragments when the subject is known.

Prefer "Which region hosts the knw service?" over "Which region?"

Configure

Create .env beside this SKILL.md from .env.example and set the service endpoint and API key. Do not print or expose the API key.

Run

Invoke the script relative to this skill directory:

uv run scripts/knw.py health
uv run scripts/knw.py store "The knw service is deployed in the eu-west-1 region."
uv run scripts/knw.py search "Which region hosts the knw service?" --limit 5
uv run scripts/knw.py delete "550e8400-e29b-41d4-a716-446655440000"

Use store with multiple arguments to save several facts in one request. Read JSON from stdout. When a command fails, read the structured JSON error from stderr and report the failure without exposing credentials.