Guide Authoring
Businessguide-authoringGuide Authoring is an Agent Skill for business published in the neomjs/neo repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Authoring OR reviewing a learn/ guide (learn/benefits/*.md, learn/agentos/*.md). Enforces the grounding discipline (memory-mine + use-the-subsystem's-tools before writing), the rich-narrative + benefits + lived-voice content bar, render-verified TD Mermaid, conceptual-vs-reference separation, the never-hand-edit-generated-files rule, and a no-rubber-stamp reviewer gate.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/neomjs/neo/blob/HEAD/.agents/skills/guide-authoring/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/guide-authoring, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Guide Authoring Skill
If you are authoring OR reviewing a learn/ guide (learn/benefits/*.md, learn/agentos/*.md), you MUST immediately use the view_file tool to read and strictly adhere to .agents/skills/guide-authoring/references/guide-authoring-bar.md before writing the first sentence or posting a review verdict.
A guide is held to a 9/10 bar: written by using the system (not inference), narrative + benefits-driven with lived voice, render-verified diagrams, reference extracted-not-inlined, and reviewed against the WHOLE bar (not the narrow required-action delta). Skipping it is the higher-cost path — MemoryCore took ~7 cycles and KnowledgeBase a rubber-stamp reversal precisely because this discipline was skipped (the operator rejects 75%+ of guides that miss it).