Felipe Martin
e68465a114
Exclude account identifiers and names from durable knowledge entries to prevent personal details from being recorded. Verified the skill frontmatter and diff formatting.
35 lines
2.2 KiB
Markdown
35 lines
2.2 KiB
Markdown
---
|
|
name: knowledge-maintain
|
|
description: Create, correct, extend, or re-verify durable repository-local agent knowledge across CLIs, libraries, APIs, workflows, and concepts. Use when asked to learn to use or learn about a CLI, library, API, workflow, or concept; when useful knowledge is missing from `.agents/knowledge/`; when an entry is incomplete or contradicted by observed behavior; or when documentation or versions have changed.
|
|
---
|
|
|
|
# Maintain local knowledge
|
|
|
|
Maintain one focused entry at `.agents/knowledge/<domain>/<name>.md`.
|
|
|
|
## Workflow
|
|
|
|
1. Read `references/domain-routing.md` and select the narrowest existing domain.
|
|
2. Read that domain's `_template.md` and look for an existing entry or close duplicate.
|
|
3. Choose the mode:
|
|
- **Create:** Research and write a missing entry.
|
|
- **Update:** State the suspected gap, verify it, and preserve unrelated valid guidance.
|
|
- **No change:** Stop when the existing entry is already sufficient and current.
|
|
4. Inspect local behavior, built-in help, versions, or configuration when safely available. Do not install, upgrade, authenticate, or mutate external systems without permission.
|
|
5. Consult authoritative, preferably primary or official, sources. Verify important claims against the applicable version or label uncertainty.
|
|
6. Write the smallest complete change using the required frontmatter and useful template sections.
|
|
7. Re-read the full entry for contradictions, unsafe omissions, unsupported claims, and malformed frontmatter.
|
|
|
|
## Rules
|
|
|
|
- Set `last_verified` to today only after checking the entry's operational claims.
|
|
- Quote `last_verified_version`; omit it when no meaningful version can be verified.
|
|
- Record only consulted URLs in a non-empty `sources` list.
|
|
- Preserve durable facts, local conventions, safety constraints, and recurring gotchas.
|
|
- Prefer examples that future agents can adapt; explain placeholders and external effects.
|
|
- Exclude credentials, tokens, account-specific or personal details (including IDs, names, and usernames), copied transient output, and task history.
|
|
- Add a domain only when existing domains do not fit and a distinct template is useful.
|
|
|
|
## Completion
|
|
|
|
Report the path, mode, verification date/version, sources changed, and unresolved limitations.
|