knowledge-activation — Skillopedia

Knowledge Activation Turn a mature corpus into operator-ready knowledge surfaces. What This Skill Does Use this skill when the problem is no longer "capture more knowledge," but: - promote the strongest recurring claims into a belief system - turn healthy topics into reusable playbooks - compile a small goal-time briefing for future work - surface thin topics and promotion gaps before they silently calcify remains the hygiene loop. owns corpus operationalization. Where this sits in the flywheel Knowledge activation is the fourth step in the global-corpus workflow: 1. — gather artifacts from m…

\"\ncheck \"SKILL.md has name: knowledge-activation\" \"grep -q '^name: knowledge-activation' '$SKILL_DIR/SKILL.md'\"\ncheck \"references/ directory exists\" \"[ -d '$SKILL_DIR/references' ]\"\ncheck \"required references exist\" \"[ -f '$SKILL_DIR/references/dag.md' ] && [ -f '$SKILL_DIR/references/output-surfaces.md' ] && [ -f '$SKILL_DIR/references/script-contracts.md' ]\"\ncheck \"scripts/validate.sh exists\" \"[ -f '$SKILL_DIR/scripts/validate.sh' ]\"\ncheck \"SKILL.md links dag reference\" \"grep -q 'references/dag.md' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md links output surfaces reference\" \"grep -q 'references/output-surfaces.md' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md links script contracts reference\" \"grep -q 'references/script-contracts.md' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions ao knowledge activate\" \"grep -q 'ao knowledge activate' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions ao knowledge gaps\" \"grep -q 'ao knowledge gaps' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions belief book output\" \"grep -q '\\.agents/knowledge/book-of-beliefs.md' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions playbooks output\" \"grep -q '\\.agents/playbooks/' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions briefings output\" \"grep -q '\\.agents/briefings/' '$SKILL_DIR/SKILL.md'\"\n\necho \"\"\necho \"Results: $PASS passed, $FAIL failed\"\n[ $FAIL -eq 0 ] && exit 0 || exit 1\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":1715,"content_sha256":"5b1968ca1ba2185cd855b87c0241685bb9f1361ca343ac3ff6b356a29fc86345"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Knowledge Activation","type":"text"}]},{"type":"paragraph","content":[{"text":"Turn a mature ","type":"text"},{"text":".agents","type":"text","marks":[{"type":"code_inline"}]},{"text":" corpus into operator-ready knowledge surfaces.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"What This Skill Does","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this skill when the problem is no longer \"capture more knowledge,\" but:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"promote the strongest recurring claims into a belief system","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"turn healthy topics into reusable playbooks","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"compile a small goal-time briefing for future work","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"surface thin topics and promotion gaps before they silently calcify","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"$compile","type":"text","marks":[{"type":"code_inline"}]},{"text":" remains the hygiene loop. ","type":"text"},{"text":"knowledge-activation","type":"text","marks":[{"type":"code_inline"}]},{"text":" owns corpus operationalization.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Where this sits in the flywheel","type":"text"}]},{"type":"paragraph","content":[{"text":"Knowledge activation is the ","type":"text"},{"text":"fourth step","type":"text","marks":[{"type":"strong"}]},{"text":" in the global-corpus workflow:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"$harvest","type":"text","marks":[{"type":"code_inline"}]},{"text":" — gather artifacts from many rigs into ","type":"text"},{"text":"~/.agents/learnings/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"$compile","type":"text","marks":[{"type":"code_inline"}]},{"text":" — synthesize raw artifacts into ","type":"text"},{"text":".agents/compiled/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"(optional)","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"$dream","type":"text","marks":[{"type":"code_inline"}]},{"text":" overnight — bounded compounding loop","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"$knowledge-activation","type":"text","marks":[{"type":"code_inline"}]},{"text":" — lift compiled knowledge into playbooks, beliefs, and runtime briefings","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Which skill do I need?","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"docs/skills-decision-tree.md","type":"text","marks":[{"type":"link","attrs":{"href":"../../docs/skills-decision-tree.md","title":null}}]},{"text":" for the full \"which skill next?\" decision table covering harvest, compile, dream, knowledge-activation, and quickstart.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Preconditions","type":"text"}]},{"type":"paragraph","content":[{"text":"This skill assumes the current workspace already has:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"a ","type":"text"},{"text":".agents/","type":"text","marks":[{"type":"code_inline"}]},{"text":" directory","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"packet refresh builders under ","type":"text"},{"text":".agents/scripts/","type":"text","marks":[{"type":"code_inline"}]},{"text":" when ","type":"text"},{"text":"ao knowledge activate","type":"text","marks":[{"type":"code_inline"}]},{"text":" needs to rebuild source manifests, topics, promoted packets, and chunk bundles from custom workspace logic","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"or ","type":"text"},{"text":".agents/harvest/latest.json","type":"text","marks":[{"type":"code_inline"}]},{"text":", which ","type":"text"},{"text":"ao knowledge activate","type":"text","marks":[{"type":"code_inline"}]},{"text":" can use as a native fallback to turn the latest harvest catalog into a ","type":"text"},{"text":"harvested-praxis","type":"text","marks":[{"type":"code_inline"}]},{"text":" topic packet, promoted packet, and chunk bundle","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"packet, topic, playbook, and briefing surfaces that can be refreshed mechanically","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Read ","type":"text"},{"text":"references/script-contracts.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/script-contracts.md","title":null}}]},{"text":" for the required builder inventory and command ownership.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Command Contract","type":"text"}]},{"type":"paragraph","content":[{"text":"The stable product surface is the ","type":"text"},{"text":"ao knowledge","type":"text","marks":[{"type":"code_inline"}]},{"text":" command family:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"ao knowledge activate --goal \"turn agents into usable information\"\nao knowledge beliefs\nao knowledge playbooks\nao knowledge brief --goal \"fix auth startup\"\nao knowledge gaps","type":"text"}]},{"type":"paragraph","content":[{"text":"The skill owns routing, sequencing, interpretation, and next-step recommendations. ","type":"text"},{"text":"ao","type":"text","marks":[{"type":"code_inline"}]},{"text":" owns the belief/playbook/brief/gap product surfaces directly.","type":"text"}]},{"type":"paragraph","content":[{"text":"ao lookup","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"ao codex start","type":"text","marks":[{"type":"code_inline"}]},{"text":" consume these outputs as operator context. Matched knowledge briefings are the preferred dynamic startup surface, while selected beliefs and healthy playbooks provide bounded supporting guidance. When a retrieved briefing, belief, or playbook changes a recommendation, record it with ","type":"text"},{"text":"ao metrics cite \"\u003cpath>\" --type applied 2>/dev/null || true","type":"text","marks":[{"type":"code_inline"}]},{"text":"; use ","type":"text"},{"text":"--type retrieved","type":"text","marks":[{"type":"code_inline"}]},{"text":" for loaded-but-unused context.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Execution Steps","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1: Preflight","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify that ","type":"text"},{"text":".agents/","type":"text","marks":[{"type":"code_inline"}]},{"text":" exists. When you plan to run ","type":"text"},{"text":"ao knowledge activate","type":"text","marks":[{"type":"code_inline"}]},{"text":", verify that at least one evidence substrate is present:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"packet builders: ","type":"text"},{"text":"source_manifest_build.py","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"topic_packet_build.py","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"corpus_packet_promote.py","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"knowledge_chunk_build.py","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"harvest fallback: ","type":"text"},{"text":".agents/harvest/latest.json","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"native operator surfaces: ","type":"text"},{"text":"ao knowledge beliefs","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"ao knowledge playbooks","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"ao knowledge brief","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"ao knowledge gaps","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2: Consolidate Evidence","type":"text"}]},{"type":"paragraph","content":[{"text":"Run the packet layers in order:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"source manifests","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"topic packets","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"promoted packets","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"historical chunk bundles","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Read ","type":"text"},{"text":"references/dag.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/dag.md","title":null}}]},{"text":" for the full DAG and its trust gates.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 3: Distill Operator Surfaces","type":"text"}]},{"type":"paragraph","content":[{"text":"Refresh the promoted operator layers:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"ao knowledge beliefs\nao knowledge playbooks","type":"text"}]},{"type":"paragraph","content":[{"text":"These should materialize the consumer surfaces under ","type":"text"},{"text":".agents/knowledge/","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":".agents/playbooks/","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 4: Compile A Goal-Time Briefing","type":"text"}]},{"type":"paragraph","content":[{"text":"When there is an active objective, compile a bounded startup aid:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"ao knowledge brief --goal \"your goal here\"","type":"text"}]},{"type":"paragraph","content":[{"text":"The briefing should stay small, cite its source surfaces, and include warnings when a selected topic is thin.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 5: Surface Gaps","type":"text"}]},{"type":"paragraph","content":[{"text":"Run:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"ao knowledge gaps","type":"text"}]},{"type":"paragraph","content":[{"text":"This reports thin topics, missing promotions, weak claims needing review, and the next recommended mining work.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 6: Full Outer Loop","type":"text"}]},{"type":"paragraph","content":[{"text":"If you want the complete pass in one step, run:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"ao knowledge activate --goal \"your goal here\"","type":"text"}]},{"type":"paragraph","content":[{"text":"That command sequences evidence consolidation, belief/playbook refresh, optional briefing compilation, and a gap summary.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Trust Rules","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"packetization is substrate, not the product","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"beliefs, playbooks, and briefings are the real operator surfaces","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"thin topics stay discovery-only until evidence improves","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"every generated surface should name its consumer","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"repeated unchanged runs should stay structurally deterministic","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Read ","type":"text"},{"text":"references/output-surfaces.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/output-surfaces.md","title":null}}]},{"text":" for the canonical output surfaces and trust boundaries.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Output Surfaces","type":"text"}]},{"type":"paragraph","content":[{"text":"The consumer-facing outputs are:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".agents/knowledge/book-of-beliefs.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".agents/playbooks/index.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".agents/playbooks/\u003ctopic>.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".agents/briefings/YYYY-MM-DD-\u003cgoal>.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".agents/retro/","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"paragraph","content":[{"text":"The substrate surfaces remain:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".agents/packets/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".agents/topics/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".agents/packets/chunks/catalog.jsonl","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Activate the full outer loop for an active goal","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"/knowledge-activation\nao knowledge activate --goal \"productize knowledge activation\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Refresh only the belief and playbook promotion layers","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"ao knowledge beliefs\nao knowledge playbooks","type":"text"}]},{"type":"paragraph","content":[{"text":"Check whether the corpus is safe to promote","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"ao knowledge gaps","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"References","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/dag.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/dag.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/script-contracts.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/script-contracts.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/output-surfaces.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/output-surfaces.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/knowledge-activation.feature","type":"text","marks":[{"type":"link","attrs":{"href":"references/knowledge-activation.feature","title":null}}]},{"text":" — Executable spec: consolidate evidence, distill beliefs/playbooks, compile goal-time briefing, surface gaps (soc-qk4b)","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}}]},"metadata":{"date":"2026-06-05","name":"knowledge-activation","author":"@skillopedia","source":{"stars":375,"repo_name":"agentops","origin_url":"https://github.com/boshu2/agentops/blob/HEAD/skills/knowledge-activation/SKILL.md","repo_owner":"boshu2","body_sha256":"5d700f1c49c3eb4d71a80b351ea52d41099a67afc1ce2669a46e2be913a7b446","cluster_key":"561ac35546dc4e0e86a4def8d4e0039de7747dcac3c4fcc6882158058a13abd3","clean_bundle":{"format":"clean-skill-bundle-v1","source":"boshu2/agentops/skills/knowledge-activation/SKILL.md","attachments":[{"id":"4b9347a7-9a02-5f8a-9f1a-2a5afa71d134","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/4b9347a7-9a02-5f8a-9f1a-2a5afa71d134/attachment.md","path":"references/dag.md","size":1304,"sha256":"c3f8c5b657e7a9a73ba28ac9335aa9093f2f9e43aef56d981f18be8babd58aef","contentType":"text/markdown; charset=utf-8"},{"id":"e02e1209-81a9-5877-be66-6768edc00664","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/e02e1209-81a9-5877-be66-6768edc00664/attachment.feature","path":"references/knowledge-activation.feature","size":1467,"sha256":"e803c27463fa8424db4c700a4eb79d5fa962f88f1c001d5108be60da6f47003e","contentType":"text/plain; charset=utf-8"},{"id":"bf4e8344-81b6-51fe-9f46-5ebe1eb61c0f","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/bf4e8344-81b6-51fe-9f46-5ebe1eb61c0f/attachment.md","path":"references/output-surfaces.md","size":1035,"sha256":"bc6df7ac94b6a536150a3df2ba566a8470326e73422fb7ef80b506952c96e095","contentType":"text/markdown; charset=utf-8"},{"id":"d2ec7445-56bf-5040-bcb7-353ab757dc83","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/d2ec7445-56bf-5040-bcb7-353ab757dc83/attachment.md","path":"references/script-contracts.md","size":1883,"sha256":"943b4f294c7174b72ed38a333aa7df852aef74adfd84238efe178b1147fb93c0","contentType":"text/markdown; charset=utf-8"},{"id":"667701f1-c5e8-588c-82ec-8f72678dae15","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/667701f1-c5e8-588c-82ec-8f72678dae15/attachment.sh","path":"scripts/validate.sh","size":1715,"sha256":"5b1968ca1ba2185cd855b87c0241685bb9f1361ca343ac3ff6b356a29fc86345","contentType":"application/x-sh; charset=utf-8"}],"bundle_sha256":"29abd4086d1f6c5c5ad3a91810bd7d76cd703ad40e582127d5fc869ca5d7a136","attachment_count":5,"text_attachments":4,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":1,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":"skills/knowledge-activation/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"general","category_label":"General"},"exact_dupes_collapsed_into_this":0},"context":{"intent":{"mode":"task"},"window":"fork","sections":{"exclude":["TASK"]},"intel_scope":"topic"},"version":"v1","category":"general","consumes":[],"metadata":{"tier":"knowledge","dependencies":["compile","harvest","flywheel"]},"produces":[],"practices":["wiki-knowledge-surface","pragmatic-programmer"],"import_tag":"clean-skills-v1","context_rel":[],"description":"Activate mature .agents knowledge.","hexagonal_role":"supporting","user-invocable":true,"output_contract":".agents/beliefs.md, .agents/playbooks/*.md, .agents/briefings/*.md","skill_api_version":1}},"renderedAt":1782986510795}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.