OpenParable
Skip to content
← Back to skills

Guide Authoring

Business
guide-authoring

Guide 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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).