Learn-skills.dev docs-knowledge-base

install
source · Clone the upstream repo
git clone https://github.com/NeverSight/learn-skills.dev
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/agglayer/agglayer-ai-skills/docs-knowledge-base" ~/.claude/skills/neversight-learn-skills-dev-docs-knowledge-base && rm -rf "$T"
manifest: data/skills-md/agglayer/agglayer-ai-skills/docs-knowledge-base/SKILL.md
source content

Use this workflow when creating or editing files under

docs/knowledge-base/
.

Audience and tone

  • Primary audience: human maintainers and contributors.
  • Secondary audience: AI agents reading project documentation.
  • Write concise, factual prose.
  • Avoid AI-specific annotations or prompt-oriented formatting.

mdbook structure

  • Keep chapter sources under
    docs/knowledge-base/src/
    .
  • Keep
    docs/knowledge-base/src/SUMMARY.md
    as the navigation source of truth.
  • When adding a new chapter, update
    SUMMARY.md
    in the same change.

Chapter format

  • One top-level heading (
    #
    ) per chapter.
  • Prefer short sections with explicit responsibilities, invariants, and workflows.
  • Link related terms to
    glossary.md
    .
  • Link to relevant code paths when making concrete claims.

Writing conventions

  • Follow semantic line breaks for prose.
  • Prefer active voice and operational wording.
  • Keep guidance implementation-neutral unless a path is repository-specific.
  • Clearly separate facts, constraints, and recommendations.

Verification

Before finishing, build the book and report the exact command and result:

mdbook build docs/knowledge-base/