Date: 2026-06-01
Status: standalone TRAE SOLO skill candidate
Scope: public contest package, ready to import into TRAE SOLO or another Agent Skills runtime.
Read this README when working on the standalone contest package for ai-knowledge-gardener.
Use skill/ai-knowledge-gardener/ as the importable skill folder. The rest of this repository contains examples, marketplace copy, and release notes.
ai-knowledge-gardener is a portable Agent Skill for Markdown-heavy workspaces. It combines two ideas:
- Context navigation: read indexes first, then only the source files that matter.
- Knowledge hygiene: after work is done, decide what should be kept, where it belongs, what became stale, and which indexes need repair.
The target user is someone whose repository, documentation folder, Obsidian vault, research notes, or AI project workspace has become too large for "just search everything" to stay reliable.
| Topic | File / path | When to read in full |
|---|---|---|
| Skill entry | skill/ai-knowledge-gardener/SKILL.md |
Understanding trigger behavior and mode selection |
| Navigation workflow | skill/ai-knowledge-gardener/references/navigation-checklist.md |
Answering discovery, tracing, or synthesis questions |
| Bootstrap workflow | skill/ai-knowledge-gardener/references/bootstrap-workflow.md |
Creating root maps and domain indexes |
| Hygiene workflow | skill/ai-knowledge-gardener/references/hygiene-workflow.md |
Task closeout, artifact routing, stale-doc cleanup |
| Index template | skill/ai-knowledge-gardener/references/index-template.md |
Creating or reviewing CONTEXT.md / INDEX.md files |
| Validator | skill/ai-knowledge-gardener/scripts/validate_indexes.py |
Checking index schema and local links |
| Example workspace | examples/minimal-workspace/ |
Demo and validation target |
| Slot | Path | Rule |
|---|---|---|
| Entry | README.md |
This package-level birth contract |
| Skill | skill/ai-knowledge-gardener/ |
Folder to import into TRAE SOLO or another Agent Skills runtime |
| References | skill/ai-knowledge-gardener/references/ |
Detailed workflows loaded only when needed |
| Scripts | skill/ai-knowledge-gardener/scripts/ |
Deterministic validation helpers |
| Examples | examples/ |
Small artificial workspaces safe for public demos |
| Marketplace copy | marketplaces/ |
Contest and listing drafts |
| User intent | First read | Then read if needed | Do not read first |
|---|---|---|---|
| Prepare the contest submission | README.md |
marketplaces/trae-post-draft.md, SKILL.md |
Personal workspace skill files |
| Edit the public skill | SKILL.md |
Relevant reference file | All examples recursively |
| Test the validator | SKILL.md |
examples/minimal-workspace/ |
Real private workspaces |
| Repackage for TRAE SOLO | README.md |
DISTRIBUTION.md if added later |
Active .agents/skills/ |
This package is inspired by the public MIT-licensed UltraDD/context-navigator-skill project and by knowledge hygiene workflows for task closeout and documentation drift control. It is rewritten as a standalone public skill and deliberately avoids private paths, personal data contracts, and workspace-specific rules.
- Keep this repository standalone and portable.
- Keep examples artificial and safe to publish.
- Run
python skill/ai-knowledge-gardener/scripts/validate_indexes.py examples/minimal-workspaceafter changing index examples or the validator. - Run the skill creator quick validator after changing
SKILL.md.