Agent skill

Sake Docs

A skill your agent uses when writing or updating Sake documentation — VitePress site structure, existing pages, how to add new docs, documentation conventions.

MITAuto-check passedFrontend & Design

Install Sake Docs

skills CLI

$ npx skills add kattouf/Sake --skill sake-docs -a claude-code

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

GitHub CLI

$ gh skill install kattouf/Sake sake-docs --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/kattouf/Sake.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/sake-docs .claude/skills/sake-docs && 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/

Paste into Claude Code

Install the "sake-docs" agent skill from https://github.com/kattouf/Sake/tree/main/.claude/skills/sake-docs into .claude/skills/sake-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sake-docs", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/kattouf/Sake/tree/main/.claude/skills/sake-docs

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add kattouf/Sake --skill sake-docs -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install kattouf/Sake sake-docs --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kattouf/Sake.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/sake-docs .agents/skills/sake-docs && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "sake-docs" agent skill from https://github.com/kattouf/Sake/tree/main/.claude/skills/sake-docs into .agents/skills/sake-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sake-docs", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add kattouf/Sake --skill sake-docs -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install kattouf/Sake sake-docs --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kattouf/Sake.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/sake-docs .cursor/skills/sake-docs && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "sake-docs" agent skill from https://github.com/kattouf/Sake/tree/main/.claude/skills/sake-docs into .cursor/skills/sake-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sake-docs", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/kattouf/Sake.git --path .claude/skills/sake-docs

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add kattouf/Sake --skill sake-docs -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install kattouf/Sake sake-docs --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kattouf/Sake.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/sake-docs .gemini/skills/sake-docs && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "sake-docs" agent skill from https://github.com/kattouf/Sake/tree/main/.claude/skills/sake-docs into .gemini/skills/sake-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sake-docs", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install kattouf/Sake sake-docs

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add kattouf/Sake --skill sake-docs -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/kattouf/Sake.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/sake-docs .github/skills/sake-docs && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "sake-docs" agent skill from https://github.com/kattouf/Sake/tree/main/.claude/skills/sake-docs into .github/skills/sake-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sake-docs", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add kattouf/Sake --skill sake-docs -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install kattouf/Sake sake-docs --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kattouf/Sake.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/sake-docs .opencode/skills/sake-docs && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "sake-docs" agent skill from https://github.com/kattouf/Sake/tree/main/.claude/skills/sake-docs into .opencode/skills/sake-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sake-docs", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: sake-docs
GitHub stars: 116
Token cost: ~778 tokens
SKILL.md length: 126 words
Files: 1
Skills in repo: 8
Repo updated: Apr 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

A skill your agent uses when writing or updating Sake documentation — VitePress site structure, existing pages, how to add new docs, documentation conventions.

Works in 4 steps: Create docs/new-page.md → Add to VitePress sidebar config in… → Cross-reference from related pages → …
Updating Sake documentation — VitePress site structure
SKILL.md covers Directory Structure, VitePress Build, Documentation Conventions and Adding a New Doc, plus 1 more section
Calls npm and swift

What it does

Sake Docs is an agent skill from kattouf/Sake. Use when writing or updating Sake documentation — VitePress site structure, existing pages, how to add new docs, documentation conventions.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Static sites and blogs. It works with VitePress and Bash. The repository describes itself as: 🍶 Swift-based utility for managing project commands, inspired by Make. The licence is MIT.

When your agent uses it

Updating Sake documentation — VitePress site structure
How to add new docs
Documentation conventions

Example prompts

“/sake-docs”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Create docs/new-page.md
Add to VitePress sidebar config in docs/.vitepress/config.mts
Cross-reference from related pages
Run cd docs && npm run docs:dev to preview locally

What it can do on your machine

Read from SKILL.md and the folder at commit 80a3e98. 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
Shell commands in SKILL.md call:
- npm
- swift
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- sakeswift.org
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

Sake Docs loads about 778 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 126 words of instructions outside code blocks.

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

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 kattouf/Sake at commit 80a3e98, republished under its MIT licence (© kattouf). 126 words, ~778 tokens.

Download SKILL.mdSave it as .claude/skills/sake-docs/SKILL.md (or your agent's skills folder).

name: sake-docs
description: Use when writing or updating Sake documentation — VitePress site structure, existing pages, how to add new docs, documentation conventions.

Sake Documentation

Documentation site: sakeswift.org, built with VitePress, deployed via GitHub Pages.

Directory Structure

All docs in docs/. Key files:

docs/
  index.md                          — landing page
  about.md                          — what Sake is
  installation.md                   — brew, mint, mise
  getting-started.md                — sake init, first command
  how-it-works.md                   — sake vs SakeApp architecture
  editing-commands.md               — sake edit, manual editing
  commands-basic-rules.md           — visibility, static, type rules
  commands-dependencies.md          — deps, concurrent, CommandRunner
  commands-conditional-execution.md — skipIf
  commands-grouping.md              — @CommandGroup, SakeAppConfiguration
  commands-name-conversions.md      — case strategies
  commands-run-context.md           — Context properties, mapArguments/mapEnvironment
  passing-arguments.md              — basic argument passing
  sharing-data-between-commands.md  — context.storage
  interruption-handling.md          — InterruptionHandler, SIGINT cleanup
  advanced-argument-parsing.md      — ArgumentParser integration
  advanced-cli-tools-running.md     — swift-subprocess usage
  advanced-extensibility-of-sakeapp.md — adding SPM dependencies
  advanced-usage-example.md         — lint + ensureInstalled example
  configuration.md                  — CLI/ENV/.sake.yml cascade
  continuous-integration.md         — prebuilding, caching, setup-sake action
  shell-completion.md               — zsh/fig completion
  experimental-features.md          — SAKE_EXPERIMENTAL_FEATURES, swift-syntax prebuilts
  troubleshooting.md                — sake clean, rm -rf SakeApp/.build
  contribution-guide.md             — formatting, testing, conventional commits
  package.json                      — npm scripts and dependencies
  .vitepress/config.mts             — VitePress sidebar/nav config

VitePress Build

bash

cd docs && npm ci && npm run docs:build

Deployed automatically on push to main (docs/** changes) via .github/workflows/docs-deploy.yml.

Documentation Conventions

VitePress markdown with ::: tip, ::: warning, ::: info containers
Code blocks with language + optional line highlighting: swift {4}
outline: deep frontmatter for deep table of contents
External tutorial links in tip blocks (Getting Started references swifttoolkit.dev articles)
Docs reference each other via relative paths: [Configuration](/configuration)

Adding a New Doc

Create docs/new-page.md
Add to VitePress sidebar config in docs/.vitepress/config.mts
Cross-reference from related pages
Run cd docs && npm run docs:dev to preview locally

Tone

Practical, example-driven
Short explanations → code example → explanation of what the code does
"In this example..." pattern for walkthroughs

Files

Just SKILL.md in .claude/skills/sake-docs of kattouf/Sake.

Open the folder on GitHubat commit 80a3e98

Compare with similar skills

Sake Docs 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.

Sake Docs compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Sake Docs this skillkattouf/Sake	116	—	~778	Automated safety check: Pass	MIT	6 mo ago
Add Astro Icont4t5/rencal	159	—	~752	Automated safety check: Pass	MIT	yesterday
Oryxos Admin UIoryx-labs/oryxos	186	—	~913	Automated safety check: Pass	Apache-2.0	yesterday
Sync Docseslint-config/airbnb-extended	129	—	~878	Automated safety check: Pass	MIT	yesterday
Docs AutomationSAP-samples/hana-developer-cli-tool-example	114	—	~344	Automated safety check: Pass	Apache-2.0	yesterday
Update Docs PRopentiny/genui-sdk	171	—	~819	Automated safety check: Pass	MIT	today

Similar skills

Add Astro Icon
t4t5/rencal
Turn raw SVG markup into an Astro icon component in website/src/icons/.
159 GitHub stars~752 tokensUpdated yesterday
Frontend & DesignAuto-check passed
Oryxos Admin UI
oryx-labs/oryxos
生成或扩展 OryxOS 的 Web 管理台（web manager）前端——Vue 3 + Vite 单页应用，视觉与官网首页（website/，VitePress）完全同源：深色底 + 橙色主色、Inter/JetBrains Mono。内置这套设计 token、工程约定（base '/admin/'、产物落 oryxos-web static/admin、SPA…
186 GitHub stars~913 tokensUpdated yesterday
Frontend & DesignAuto-check passed
Sync Docs
eslint-config/airbnb-extended
Check that the VitePress docs in docs/ match the real exports, rules and CLI options in the code, then fix any drift.
129 GitHub stars~878 tokensUpdated yesterday
Frontend & DesignAuto-check passed
Docs Automation
SAP-samples/hana-developer-cli-tool-example
Automate docs updates and command documentation generation. An agent skill from SAP-samples/hana-developer-cli-tool-example.
114 GitHub stars~344 tokensUpdated yesterday
Frontend & DesignAuto-check passed
Update Docs PR
opentiny/genui-sdk
After publishing a new @opentiny/genui-sdk package, update opentiny/docs (submodule, genui package versions, VitePress sidebar) and opentiny/opentiny.design (submodule commit only), then open PRs on…
171 GitHub stars~819 tokensUpdated today
Frontend & DesignAuto-check passed
Markdown Integration
live-codes/livecodes
Integrate LiveCodes with documentation sites using remark-livecodes, markdown-it-livecodes, gatsby-remark-livecodes, or marked-livecodes for Docusaurus, Astro, VitePress, Next.js, and Storybook.
1.5k GitHub stars~2k tokensUpdated today
Frontend & DesignAuto-check passed

Questions about Sake Docs

What does Sake Docs do?

A skill your agent uses when writing or updating Sake documentation — VitePress site structure, existing pages, how to add new docs, documentation conventions. Sake Docs is an agent skill from kattouf/Sake. Use when writing or updating Sake documentation — VitePress site structure, existing pages, how to add new docs, documentation conventions.

When should I use Sake Docs?

Sake Docs fits situations like: updating Sake documentation — VitePress site structure; how to add new docs; documentation conventions.

How do I install Sake Docs in Claude Code?

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

How do I install Sake Docs in Codex?

Run `npx skills add kattouf/Sake --skill sake-docs -a codex`. Or copy the skill folder (.claude/skills/sake-docs in kattouf/Sake) into .agents/skills/sake-docs in your project. Codex loads it when a task matches its description.

Can I use Sake Docs 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 kattouf/Sake --skill sake-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sake-docs, .gemini/skills/sake-docs, .github/skills/sake-docs and .opencode/skills/sake-docs in your project.

What does Sake Docs need to run?

Going by SKILL.md and its folder, Sake Docs needs the command-line tools its instructions call (npm and swift).

Does Sake Docs access the network?

SKILL.md names 1 domain. As links in the text: sakeswift.org. This is read from the text; nothing was executed.

Is Sake Docs 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 Sake Docs use?

Sake Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sake Docs use?

About 778 tokens (SKILL.md is roughly 3.1k 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 Sake Docs?

Skills that share tags, products or a category with Sake Docs: Add Astro Icon (t4t5/rencal, 159 stars), Oryxos Admin UI (oryx-labs/oryxos, 186 stars), Sync Docs (eslint-config/airbnb-extended, 129 stars) and Docs Automation (SAP-samples/hana-developer-cli-tool-example, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sake Docs?

kattouf (a GitHub user) maintains it in kattouf/Sake, which has 116 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on April 5, 2026.

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

Sake Docs

Install Sake Docs

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Sake Documentation

Directory Structure

VitePress Build

Documentation Conventions

Adding a New Doc

Tone

Files

Compare with similar skills

Similar skills

Add Astro Icon

Oryxos Admin UI

Sync Docs

Docs Automation

Update Docs PR

Markdown Integration

More from kattouf/Sake

Sake CI Release

Sake CLI Architecture

Sake Command Patterns

Sake Config System

Sake Macro Development

Sake Testing

Questions about Sake Docs

Install Sake Docs

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Sake Documentation

Directory Structure

VitePress Build

Documentation Conventions

Adding a New Doc

Tone

Files

Compare with similar skills

Similar skills

More from kattouf/Sake

Related

Questions about Sake Docs