User Flow Diagram
Owl-Listener/designer-skills
Diagram screen-level paths, decision points, and branch logic.
A skill your agent uses when writing, editing, restructuring, or auditing Archestra documentation under docs/pages/ — new feature docs, page rewrites, sidebar and information-architecture changes…
Install Archestra Docs Writer
$ npx skills add archestra-ai/archestra --skill archestra-docs-writer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install archestra-ai/archestra archestra-docs-writer --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/archestra-ai/archestra.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/archestra-docs-writer .claude/skills/archestra-docs-writer && rm -rf skills-srcUse ~/.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/
Install the "archestra-docs-writer" agent skill from https://github.com/archestra-ai/archestra/tree/main/.agents/skills/archestra-docs-writer into .claude/skills/archestra-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "archestra-docs-writer", 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 install https://github.com/archestra-ai/archestra/tree/main/.agents/skills/archestra-docs-writerType 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.
$ npx skills add archestra-ai/archestra --skill archestra-docs-writer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install archestra-ai/archestra archestra-docs-writer --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/archestra-ai/archestra.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/archestra-docs-writer .agents/skills/archestra-docs-writer && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "archestra-docs-writer" agent skill from https://github.com/archestra-ai/archestra/tree/main/.agents/skills/archestra-docs-writer into .agents/skills/archestra-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "archestra-docs-writer", 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.
$ npx skills add archestra-ai/archestra --skill archestra-docs-writer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install archestra-ai/archestra archestra-docs-writer --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/archestra-ai/archestra.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/archestra-docs-writer .cursor/skills/archestra-docs-writer && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "archestra-docs-writer" agent skill from https://github.com/archestra-ai/archestra/tree/main/.agents/skills/archestra-docs-writer into .cursor/skills/archestra-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "archestra-docs-writer", 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 https://github.com/archestra-ai/archestra.git --path .agents/skills/archestra-docs-writer--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add archestra-ai/archestra --skill archestra-docs-writer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install archestra-ai/archestra archestra-docs-writer --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/archestra-ai/archestra.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/archestra-docs-writer .gemini/skills/archestra-docs-writer && rm -rf skills-srcUse ~/.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/
Install the "archestra-docs-writer" agent skill from https://github.com/archestra-ai/archestra/tree/main/.agents/skills/archestra-docs-writer into .gemini/skills/archestra-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "archestra-docs-writer", 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.
$ gh skill install archestra-ai/archestra archestra-docs-writerInstalls 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).
$ npx skills add archestra-ai/archestra --skill archestra-docs-writer -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/archestra-ai/archestra.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/archestra-docs-writer .github/skills/archestra-docs-writer && rm -rf skills-srcUse ~/.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/
Install the "archestra-docs-writer" agent skill from https://github.com/archestra-ai/archestra/tree/main/.agents/skills/archestra-docs-writer into .github/skills/archestra-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "archestra-docs-writer", 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.
$ npx skills add archestra-ai/archestra --skill archestra-docs-writer -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install archestra-ai/archestra archestra-docs-writer --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/archestra-ai/archestra.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/archestra-docs-writer .opencode/skills/archestra-docs-writer && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "archestra-docs-writer" agent skill from https://github.com/archestra-ai/archestra/tree/main/.agents/skills/archestra-docs-writer into .opencode/skills/archestra-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "archestra-docs-writer", 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
archestra-docs-writer- GitHub stars
- 4.4k
- Token cost
- ~5.3k tokens
- SKILL.md length
- 3,477 words
- Files
- 3 (incl. references)
- Skills in repo
- 23
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
A skill your agent uses when writing, editing, restructuring, or auditing Archestra documentation under docs/pages/ — new feature docs, page rewrites, sidebar and information-architecture changes…
- Works in 3 steps: The bottom line first: one plain… → Then the body, as one of → Then at most three "What to know"…
- Auditing Archestra documentation under docs/pages/ — new feature docs
- SKILL.md covers The Bar, The Shape of a Section, The First Line Earns the Reader and Depth Follows Difficulty, plus 7 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Archestra Docs Writer is an agent skill from archestra-ai/archestra. Use when writing, editing, restructuring, or auditing Archestra documentation under docs/pages/ — new feature docs, page rewrites, sidebar and information-architecture changes, tone or copy fixes, diagrams, and docs screenshots.
Its SKILL.md is about 5.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/audit-and-validation.md` and `references/site-mechanics.md`).
It sits in Frontend & Design, covering UX design, Diagrams and MCP servers. The repository describes itself as: Enterprise AI Platform with guardrails, MCP registry, gateway & orchestrator.
When your agent uses it
- Auditing Archestra documentation under docs/pages/ — new feature docs
- Sidebar and information-architecture changes
- Docs screenshots
Example prompts
- “/archestra-docs-writer”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- The bottom line first: one plain sentence that says what this is, what you do here, or the rule of thumb. No warm-up.
- Then the body, as one of
- Then at most three "What to know" bullets for the facts a reader could get wrong.
What it can do on your machine
Read from SKILL.md and the folder at commit aa7ab51. 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
Archestra Docs Writer loads about 5.3k tokens when it runs, and up to ~8.7k if it reads all its reference files. Until then it costs about 63 tokens; SKILL.md has 3,477 words of instructions outside code blocks.
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
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 3,477 words (~5,327 tokens).
“This skill is the single source of truth for Archestra docs. Read all of it, and read Site Mechanics, before you change a page.”
- name
- archestra-docs-writer
Files
SKILL.md and 2 other files (references) in .agents/skills/archestra-docs-writer of archestra-ai/archestra.
- SKILL.md
- references/audit-and-validation.md
- references/site-mechanics.md
Open the folder on GitHubat commit aa7ab51
Compare with similar skills
Archestra Docs Writer 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Archestra Docs Writer this skillarchestra-ai/archestra | 4.4k | — | ~5.3k | Automated safety check: Pass | Custom licence | |
| User Flow DiagramOwl-Listener/designer-skills | 2.9k | 1 repos | ~448 | Automated safety check: Pass | MIT | |
| UI Automation Workflowsconorluddy/xclaude-plugin | 183 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Penpot Uiux Designgithub/awesome-copilot | 40k | 1 repos | ~3k | Automated safety check: Pass | MIT | |
| Draft Flowjeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~898 | Automated safety check: Notes | MIT | |
| Fast Agent Designevalstate/fast-agent | 3.9k | — | ~220 | Automated safety check: Pass | Apache-2.0 |
Similar skills
UI Automation Workflows
conorluddy/xclaude-plugin
Accessibility-first UI automation using IDB. An agent skill from conorluddy/xclaude-plugin.
- Official
Penpot Uiux Design
github/awesome-copilot
Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools.
Draft Flow
jeremylongshore/tons-of-skills-marketplace
A skill your agent uses when asked to design a user flow, map how a user moves through a feature, create a wireframe or flow diagram, or document interaction design for a product brief.
Fast Agent Design
evalstate/fast-agent
A skill your agent uses to generate well-branded interfaces and assets for fast-agent, either for production or throwaway prototypes/mocks/etc.
Architecture Map
almendili/skills
Build or update an interactive isometric map of a repository's architecture — buildings sized by real measurements, neighborhoods by subsystem, animated flows tracing actual call paths, and a drift…
More from archestra-ai/archestra
All 23 skills in this repoMigrate To Archestra
archestra-ai/archestra
Migrate an existing agentic PoC/pilot (Claude Code project files, MCP configs, hooks, local tools, openclaw config, or similar hand-rolled setup artifacts) into an Archestra instance.
Archestra Dev Testing
archestra-ai/archestra
A skill your agent uses for test selection and quality across backend, frontend, and e2e; load its backend reference for Vitest projects, mocking, DB fixtures, and performance.
Archestra Dev Backend
archestra-ai/archestra
A skill your agent uses when adding or changing Archestra backend routes, models, services, API request/response schemas, endpoint permissions, or OpenAPI/codegen for the generated API client.
Archestra Dev E2E
archestra-ai/archestra
A skill your agent uses when writing, debugging, or running Archestra Playwright e2e tests, API/UI fixtures, WireMock-backed tests, local/CI e2e setup, or test selectors.
Archestra Dev Frontend
archestra-ai/archestra
A skill your agent uses when modifying Archestra frontend Next.js/React code, UI components, forms, TanStack Query hooks, generated API client usage, frontend copy, or documentation links.
Archestra Dev LLM Providers
archestra-ai/archestra
A skill your agent uses when adding an LLM provider, changing proxy adapters or provider routes, fixing streaming/tool-call translation bugs, editing model fetchers or model handling, or touching…
Related
Questions about Archestra Docs Writer
What does Archestra Docs Writer do?
A skill your agent uses when writing, editing, restructuring, or auditing Archestra documentation under docs/pages/ — new feature docs, page rewrites, sidebar and information-architecture changes…. Archestra Docs Writer is an agent skill from archestra-ai/archestra. Use when writing, editing, restructuring, or auditing Archestra documentation under docs/pages/ — new feature docs, page rewrites, sidebar and information-architecture changes, tone or copy fixes, diagrams, and docs screenshots.
When should I use Archestra Docs Writer?
Archestra Docs Writer fits situations like: auditing Archestra documentation under docs/pages/ — new feature docs; sidebar and information-architecture changes; docs screenshots.
How do I install Archestra Docs Writer in Claude Code?
Run `npx skills add archestra-ai/archestra --skill archestra-docs-writer -a claude-code`. Or copy the skill folder (.agents/skills/archestra-docs-writer in archestra-ai/archestra) into .claude/skills/archestra-docs-writer in your project. Claude Code loads it when a task matches its description.
How do I install Archestra Docs Writer in Codex?
Run `npx skills add archestra-ai/archestra --skill archestra-docs-writer -a codex`. Or copy the skill folder (.agents/skills/archestra-docs-writer in archestra-ai/archestra) into .agents/skills/archestra-docs-writer in your project. Codex loads it when a task matches its description.
Can I use Archestra Docs Writer 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 archestra-ai/archestra --skill archestra-docs-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/archestra-docs-writer, .gemini/skills/archestra-docs-writer, .github/skills/archestra-docs-writer and .opencode/skills/archestra-docs-writer in your project.
What does Archestra Docs Writer need to run?
SKILL.md names no scripts, command-line tools or credentials: Archestra Docs Writer is instructions for the agent only.
Does Archestra Docs Writer 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 Archestra Docs Writer 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 Archestra Docs Writer use?
Archestra Docs Writer has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Archestra Docs Writer use?
About 5.3k tokens (SKILL.md is roughly 21k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.3k tokens, read only when the agent opens those files.
What are the alternatives to Archestra Docs Writer?
Skills that share tags, products or a category with Archestra Docs Writer: User Flow Diagram (Owl-Listener/designer-skills, 2.9k stars), UI Automation Workflows (conorluddy/xclaude-plugin, 183 stars), Penpot Uiux Design (github/awesome-copilot, 40k stars) and Draft Flow (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Archestra Docs Writer?
archestra-ai (a GitHub organization) maintains it in archestra-ai/archestra, which has 4,359 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 10, 2026.
Source: archestra-ai/archestra on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.