fmartingr/dotfiles
fmartingr/dotfiles
Watch
1
0
Fork
You've already forked dotfiles
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
dotfiles/home/dot_agents/skills/knowledge-maintain/SKILL.md
Felipe Martin e68465a114
 Keep account details out of agent knowledge 
Exclude account identifiers and names from durable knowledge entries to prevent personal details from being recorded. Verified the skill frontmatter and diff formatting.
2026-08-31 14:58:32 +02:00

2.2 KiB
Raw Permalink Blame History

name description
knowledge-maintain 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.