Agent skill

Docouture Docs Versioning

by InditexTech in InditexTech/weavejs

How to cut a release or a prerelease on a docouture Antora documentation site scaffolded with Versioned (Full History) mode: docouture version, docs/.release-version, and the docouture-release.yml…

Apache-2.0Auto-check passedDevelopment

Install Docouture Docs Versioning

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

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

GitHub CLI
$ gh skill install InditexTech/weavejs docouture-docs-versioning --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-versioning .claude/skills/docouture-docs-versioning && 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-versioning
GitHub stars
208
Token cost
~655 tokens
SKILL.md length
299 words
Files
2
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

How to cut a release or a prerelease on a docouture Antora documentation site scaffolded with Versioned (Full History) mode: docouture version, docs/.release-version, and the docouture-release.yml…

  • Bumping a version
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Cutting a release
  • Configuring what a release tag contains

What it does

Docouture Docs Versioning is an agent skill from InditexTech/weavejs. How to cut a release or a prerelease on a docouture Antora documentation site scaffolded with Versioned (Full History) mode: docouture version, docs/.release-version, and the docouture-release.yml workflow. USE WHEN bumping a version, cutting a release, configuring what a release tag contains, or asking how versioning works on this site. EXAMPLES: 'cut a release', 'bump the docs version', 'what does docs/.release-version do', 'how do I release a new version of the docs'.

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `reference/releasing.md`).

It sits in Development, covering Project scaffolding and Static sites and blogs. 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

  • Bumping a version
  • Cutting a release
  • Configuring what a release tag contains
  • Asking how versioning works on this site

Example prompts

  • “cut a release”
  • “bump the docs version”
  • “what does docs/.release-version do”
  • “/docouture-docs-versioning”

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 Versioning loads about 655 tokens when it runs. Until then it costs about 125 tokens; SKILL.md has 299 words of instructions outside code blocks.

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

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). 299 words, ~655 tokens.

Download SKILL.mdSave it as .claude/skills/docouture-docs-versioning/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
docouture-docs-versioning
description
How to cut a release or a prerelease on a docouture Antora documentation site scaffolded with Versioned (Full History) mode: docouture version, docs/.release-version, and the docouture-release.yml workflow. USE WHEN bumping a version, cutting a release, configuring what a release tag contains, or asking how versioning works on this site. EXAMPLES: 'cut a release', 'bump the docs version', 'what does docs/.release-version do', 'how do I release a new version of the docs'.

Docs versioning (Versioned — Full History)

Applies to a site scaffolded with docouture new --mode versioned. main is permanently the prerelease/preview channel; every release is its own immutable docs/vX.Y.Z git tag, and all of them stay in the version dropdown forever — the shape to use when consumers pin an old version and need its docs to keep existing unchanged.

See reference/releasing.md for the full mechanism (what each file says on main vs. on a release tag, and what the release workflow actually does).

The short version

  • docs/src/antora.yml on main always says version: prerelease, prerelease: true — never edit this by hand to "cut" a release; it doesn't change on main at all. A release tag gets its own copy of this file, with version: '1.2.0', prerelease: false.
  • docouture version <value> is the one piece of this the CLI does for you locally — it patches docs/src/antora.yml's version:/prerelease: fields. Useful for testing a version bump locally; the actual release workflow uses the same command internally.
  • docs/.release-version holds the next planned version (e.g. 1.2.0) as plain text. It's what a merged, docs/release-labeled pull request uses to tell the release workflow what to tag — review it like any other file in that PR's diff.
  • Cutting a release happens through the docouture-release.yml GitHub Actions workflow (.github/workflows/), not a local CLI command — see reference/releasing.md for why. Trigger it either by:
    • running it by hand (workflow_dispatch), giving the target version as input, or
    • merging a pull request labeled docs/release into main — it reads the target version from docs/.release-version.
  • After a genuine new release (not a republish of an existing tag), the workflow bumps docs/.release-version forward to the next patch version automatically and commits that to main — you shouldn't normally need to edit it yourself except to set an intentionally different next target (e.g. jumping to a new minor).

© 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 1 other file in .agents/skills/docouture-docs-versioning of InditexTech/weavejs.

  • SKILL.md
  • reference/releasing.md

Open the folder on GitHubat commit 2bd3672

Compare with similar skills

Docouture Docs Versioning 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 Versioning compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docouture Docs Versioning this skillInditexTech/weavejs208—~655Automated safety check: PassApache-2.0
Edgeone Makers RecipesTencentEdgeOne/edgeone-makers-tools1.9k1 repos~2.6kAutomated safety check: PassMIT
Create Ryos Appryokun6/ryos1.3k—~3.7kAutomated safety check: PassAGPL-3.0
Uui Documentationepam/UUI248—~1.3kAutomated safety check: PassMIT
Setup Workspaceprobabl-ai/skills135—~1.5kAutomated safety check: PassBSD-3-Clause
Cabloy Resource Field Updatecabloy/cabloy982—~3.4kAutomated safety check: PassMIT

Similar skills

  • Edgeone Makers Recipes

    TencentEdgeOne/edgeone-makers-tools

    Project structure templates and scaffolding recipes for typical EdgeOne Makers applications — full-stack apps, static sites, API services, and AI agent projects.

    1.9k GitHub starsUsed in 1 repo~2.6k tokens
    Backend & APIsAuto-check passed
  • Create Ryos App

    ryokun6/ryos

    Create new applications for ryOS following established patterns and conventions.

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

    248 GitHub stars~1.3k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Setup Workspace

    probabl-ai/skills

    Detect an existing ML workspace or scaffold a fresh one via python -m skoreskills scaffold --package <pkg.

    135 GitHub stars~1.5k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • A skill your agent uses whenever the user wants to update a field on an existing Cabloy backend resource: add a new persisted field, refine validation, add enum-like constraints, attach or change…

    982 GitHub stars~3.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Cabloy Workflow

    cabloy/cabloy

    This skill should be used when the main Cabloy problem is workflow routing before implementation: deciding between Vona backend scaffolding, Zova frontend scaffolding, contract-loop work, or…

    982 GitHub stars~3.3k tokensUpdated today
    DevelopmentAuto-check: notes

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 Docs Internals

    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…

    208 GitHub stars~1k tokensUpdated 2 days ago
    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

Questions about Docouture Docs Versioning

What does Docouture Docs Versioning do?

How to cut a release or a prerelease on a docouture Antora documentation site scaffolded with Versioned (Full History) mode: docouture version, docs/.release-version, and the docouture-release.yml…. Docouture Docs Versioning is an agent skill from InditexTech/weavejs.yml workflow.

When should I use Docouture Docs Versioning?

Docouture Docs Versioning fits situations like: bumping a version; cutting a release; configuring what a release tag contains; asking how versioning works on this site.

How do I install Docouture Docs Versioning in Claude Code?

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

How do I install Docouture Docs Versioning in Codex?

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

Can I use Docouture Docs Versioning 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-versioning -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-versioning, .gemini/skills/docouture-docs-versioning, .github/skills/docouture-docs-versioning and .opencode/skills/docouture-docs-versioning in your project.

What does Docouture Docs Versioning need to run?

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

Does Docouture Docs Versioning 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 Versioning 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 Versioning use?

Docouture Docs Versioning 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 Versioning use?

About 655 tokens (SKILL.md is roughly 2.6k 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 Versioning?

Skills that share tags, products or a category with Docouture Docs Versioning: Edgeone Makers Recipes (TencentEdgeOne/edgeone-makers-tools, 1.9k stars), Create Ryos App (ryokun6/ryos, 1.3k stars), Uui Documentation (epam/UUI, 248 stars) and Setup Workspace (probabl-ai/skills, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docouture Docs Versioning?

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.