Agent skill

Docouture Docs Internals

by InditexTech in InditexTech/weavejs

How a docouture Antora documentation site is put together: the playbook, the docs/antora.yml component descriptor, the four names that must agree, the ROOT+main default layout, promoting…

Apache-2.0Auto-check passedDevelopment

Install Docouture Docs Internals

skills CLI
$ npx skills add InditexTech/weavejs --skill docouture-docs-internals -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install InditexTech/weavejs docouture-docs-internals --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/InditexTech/weavejs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/docouture-docs-internals .claude/skills/docouture-docs-internals && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
docouture-docs-internals
GitHub stars
208
Token cost
~1k tokens
SKILL.md length
339 words
Files
4
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

How a docouture Antora documentation site is put together: the playbook, the docs/antora.yml component descriptor, the four names that must agree, the ROOT+main default layout, promoting…

  • Renaming the site/component
  • SKILL.md covers The moving pieces and Versioning
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Deciding whether a section

What it does

Docouture Docs Internals is an agent skill from InditexTech/weavejs. How a docouture Antora documentation site is put together: the playbook, the docs/antora.yml component descriptor, the four names that must agree, the ROOT+main default layout, promoting Guides/Reference to their own modules, the per-artifact-module strategy for a monorepo, and the home-page vs. content-page patterns. USE WHEN adding a page or module, renaming the site/component, deciding whether a section or artifact earns its own module, building a landing/home page, or diagnosing a site that builds with zero…

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `reference/antora-extensions.md`, `reference/naming.md` and `reference/page-patterns.md`).

It sits in Development, covering Static sites and blogs and Monorepo tooling. The repository describes itself as: Weave.js is an open source library to build real-time collaboration applications like whiteboards, diagram editors, etc. on HTML5 Canvas with your own UI. The licence is Apache-2.0.

When your agent uses it

  • Renaming the site/component
  • Deciding whether a section
  • Artifact earns its own module
  • Building a landing/home page

Example prompts

  • “start page not found”
  • “add a new module”
  • “rename this docs site”
  • “/docouture-docs-internals”

What it can do on your machine

Read from SKILL.md and the folder at commit 2bd3672. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Docouture Docs Internals loads about 1k tokens when it runs. Until then it costs about 194 tokens; SKILL.md has 339 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~194
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from InditexTech/weavejs at commit 2bd3672, republished under its Apache-2.0 licence (© InditexTech). 339 words, ~1,045 tokens.

Download SKILL.mdSave it as .claude/skills/docouture-docs-internals/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
docouture-docs-internals
description
How a docouture Antora documentation site is put together: the playbook, the docs/antora.yml component descriptor, the four names that must agree, the ROOT+main default layout, promoting Guides/Reference to their own modules, the per-artifact-module strategy for a monorepo, and the home-page vs. content-page patterns. USE WHEN adding a page or module, renaming the site/component, deciding whether a section or artifact earns its own module, building a landing/home page, or diagnosing a site that builds with zero pages or fails with 'start page not found'. EXAMPLES: 'add a new module', 'rename this docs site', 'build a marketing home page', 'the site builds but has no pages', 'start page not found', 'should this artifact get its own module'.

Site structure

This site was scaffolded by docouture new (@inditextech/docouture-cli). This skill covers the pieces that make it hang together — where each name is set, how a page becomes reachable, and the two page patterns (home vs. content) worth copying rather than reinventing.

  • reference/naming.md — the four names that must agree, and how to fix them when they don't (docouture doctor checks this automatically).
  • reference/page-patterns.md — the home-page block structure, the recurring content-page shapes, the always-present ROOT + main layout, and how a site grows more modules (promoted sections, or one per artifact in a monorepo).
  • reference/antora-extensions.md — what @inditextech/docouture-antora-extensions (a different kind of extension from the authoring blocks in docouture-writing-docs-pages) provides: the module switcher, site footer, search index and llms.txt generation.

For AsciiDoc authoring itself — xrefs, admonitions, code blocks, this site's custom blocks — see the docouture-writing-docs-pages skill. For which modules/pages a site should have in the first place, see docouture-getting-started (new site) or docouture-documenting-changes (an existing site gaining a new module/artifact).

The moving pieces

docs/
  antora-playbook.yml          site title, content source, UI bundle, asciidoc/antora extensions
  antora-playbook.local.yml    same shape, but content.sources[] is just `branches: HEAD` —
                                 what `docouture dev` and PR verification build against, since a
                                 PR/feature-branch checkout doesn't have `main` or a release tag
  package.json                 name, devDependencies (docouture-cli, ui-bundle, the two extension
                                 packages), the `build`/`dev` scripts
  src/
    antora.yml                 component descriptor: name, title, version, nav
    modules/<module>/nav.adoc  navigation tree, one per module

The whole starter template — package.json, both playbooks, the nested src/ — was copied under this repository's own docs/, so antora-playbook.yml lives at <repo-root>/docs/antora-playbook.yml and the component descriptor ends up one level further down, at docs/src/antora.yml. That's why antora-playbook.yml's content.sources[0] reads url: .. (this repo's root, one level up from docs/) and start_path: docs/src.

docs/build/ (git-ignored) is generated output, not part of this tree — never edit or delete it directly. If docouture dev is running, it owns that directory and rebuilds it live on every save; a second, ad-hoc build into the same path (or clearing it by hand) pulls the site out from under that running server.

Versioning

docs/antora.yml's version/prerelease fields are identical on main regardless of which versioning mode this site uses (version: prerelease, prerelease: true) — what differs is only which git refs antora-playbook.yml's content.sources[0] aggregates from (tags: ['docs/stable'] vs. tags: ['docs/v*']). If this site was scaffolded with --mode versioned, see the docouture-docs-versioning skill for cutting a release; a standalone-mode site (the default) has no separate skill for this — docouture doctor and the docouture-release.yml workflow are all that's needed.

© InditexTech, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in .agents/skills/docouture-docs-internals of InditexTech/weavejs.

  • SKILL.md
  • reference/antora-extensions.md
  • reference/naming.md
  • reference/page-patterns.md

Open the folder on GitHubat commit 2bd3672

Compare with similar skills

Docouture Docs Internals next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Docouture Docs Internals compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docouture Docs Internals this skillInditexTech/weavejs208—~1kAutomated safety check: PassApache-2.0
Astro Developerwithastro/astro63k1 repos~1.5kAutomated safety check: PassCustom licence
Changesetwithastro/astro63k—~1.1kAutomated safety check: PassCustom licence
Create Docsvictorgarciaesgi/nuxt-typed-router4132 repos~2.8kAutomated safety check: PassMIT
Orchardcore Docs WriterOrchardCMS/OrchardCore8.2k—~1.1kAutomated safety check: PassBSD-3-Clause
UIInsForge/InsForge13k—~458Automated safety check: PassApache-2.0

Similar skills

  • Astro Developer

    withastro/astro

    Official

    Comprehensive guide for developing in the Astro monorepo. An agent skill from withastro/astro.

    63k GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed
  • Changeset

    withastro/astro

    Official

    Create a changeset for the Astro monorepo. An agent skill from withastro/astro.

    63k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Create Docs

    victorgarciaesgi/nuxt-typed-router

    Create complete documentation sites for projects. An agent skill from victorgarciaesgi/nuxt-typed-router.

    413 GitHub starsUsed in 2 repos~2.8k tokens
    Frontend & DesignAuto-check passed
  • Orchardcore Docs Writer

    OrchardCMS/OrchardCore

    Authors OrchardCore documentation — MkDocs Material pages, module README docs, nav entries, admonitions, tabbed content, and redirects.

    8.2k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • UI

    InsForge/InsForge

    A skill your agent uses when contributing to InsForge's reusable UI package.

    13k GitHub stars~458 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Helps update UUI documentation, add doc examples, configure Property Explorer, and manage component API documentation.

    248 GitHub stars~1.3k tokensUpdated 9 days ago
    DevelopmentAuto-check passed

More from InditexTech/weavejs

All 9 skills in this repo
  • Writing Fragments

    InditexTech/weavejs

    Grilling session that mines the user for fragments — heterogeneous nuggets of writing (claims, vignettes, sharp sentences, half-thoughts) — and appends them to a single document as raw material for…

    208 GitHub starsUsed in 4 repos~828 tokens
    Auto-check: warnings
  • Writing Beats

    InditexTech/weavejs

    Shape an article as a journey of beats, choose-your-own-adventure style.

    208 GitHub starsUsed in 3 repos~705 tokens
    Auto-check passed
  • Docouture Authoring Guides

    InditexTech/weavejs

    What to write on each page of a docouture documentation site: the purpose of every page, the section skeleton it needs, what to say in each section, a copyable AsciiDoc starting point and a quality…

    208 GitHub stars~3.9k tokensUpdated 2 days ago
    Auto-check passed
  • Writing Shape

    InditexTech/weavejs

    Take a markdown file of raw material and shape it into an article through a conversational session — drafting candidate openings, growing the piece paragraph by paragraph, arguing about format…

    208 GitHub starsUsed in 3 repos~1.1k tokens
    Auto-check passed
  • Docouture Writing Docs Pages

    InditexTech/weavejs

    How to author AsciiDoc content in a docouture Antora documentation site — the content tree, xref: references, nav.adoc, admonitions, code blocks, and this site's own custom blocks (tabs, cards…

    208 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • How to update an existing docouture documentation site when a feature, change, deprecation or fix lands in the repo — figuring out what's affected from a diff/commit/PR, confirming with the user…

    208 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed

Questions about Docouture Docs Internals

What does Docouture Docs Internals do?

How a docouture Antora documentation site is put together: the playbook, the docs/antora.yml component descriptor, the four names that must agree, the ROOT+main default layout, promoting…. Docouture Docs Internals is an agent skill from InditexTech/weavejs.yml component descriptor, the four names that must agree, the ROOT+main default layout, promoting Guides/Reference to their own modules, the per-artifact-module strategy for a monorepo, and the home-page vs.

When should I use Docouture Docs Internals?

Docouture Docs Internals fits situations like: renaming the site/component; deciding whether a section; artifact earns its own module; building a landing/home page.

How do I install Docouture Docs Internals in Claude Code?

Run `npx skills add InditexTech/weavejs --skill docouture-docs-internals -a claude-code`. Or copy the skill folder (.agents/skills/docouture-docs-internals in InditexTech/weavejs) into .claude/skills/docouture-docs-internals in your project. Claude Code loads it when a task matches its description.

How do I install Docouture Docs Internals in Codex?

Run `npx skills add InditexTech/weavejs --skill docouture-docs-internals -a codex`. Or copy the skill folder (.agents/skills/docouture-docs-internals in InditexTech/weavejs) into .agents/skills/docouture-docs-internals in your project. Codex loads it when a task matches its description.

Can I use Docouture Docs Internals in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add InditexTech/weavejs --skill docouture-docs-internals -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docouture-docs-internals, .gemini/skills/docouture-docs-internals, .github/skills/docouture-docs-internals and .opencode/skills/docouture-docs-internals in your project.

What does Docouture Docs Internals need to run?

SKILL.md names no scripts, command-line tools or credentials: Docouture Docs Internals is instructions for the agent only.

Does Docouture Docs Internals access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Docouture Docs Internals safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Docouture Docs Internals use?

Docouture Docs Internals is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Docouture Docs Internals use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Docouture Docs Internals?

Skills that share tags, products or a category with Docouture Docs Internals: Astro Developer (withastro/astro, 63k stars), Changeset (withastro/astro, 63k stars), Create Docs (victorgarciaesgi/nuxt-typed-router, 413 stars) and Orchardcore Docs Writer (OrchardCMS/OrchardCore, 8.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docouture Docs Internals?

InditexTech (a GitHub organization) maintains it in InditexTech/weavejs, which has 208 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 5, 2026.

Source: InditexTech/weavejs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.