openmove/engineering-design-playbook / .agents/skills/design-docs-template/update-skills
docs-template-update-skills
VerifiedRefreshes the design-docs-template skill trees in this repo (and optionally personal skill dirs) from the GitHub template latest main. Use when the user says update-skills, self-update, refresh the docs skills, or pull the latest skill from the template. Invoked via design-docs-template.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.1 KB |
SKILL.md
View on GitHub---
name: docs-template-update-skills
description: >-
Refreshes the design-docs-template skill trees in this repo (and optionally
personal skill dirs) from the GitHub template latest main. Use when the user
says update-skills, self-update, refresh the docs skills, or pull the latest
skill from the template. Invoked via design-docs-template.
---
# update-skills — refresh from GitHub
**What:** Overwrite local `design-docs-template` skill copies with the latest from the template repo.
**When:** “Aggiorna le skill”, “self-update”, after the playbook/template published new commands.
**Not:** Updating `docs/` or `website/` content; not a git pull of the whole project.
## Process
### 1. Pick the source flavour
Default from context:
| Clue | Source |
| --- | --- |
| **Default in this playbook** | `openmove/engineering-design-playbook` |
| User asks for generic upstream | `alessandroros/design-docs-template` |
| Unclear | Ask once |
Skill path inside the source (identical on all flavours):
`.cursor/skills/design-docs-template`
(Use that tree as the canonical download; it matches `.claude` / `.agents` content.)
### 2. Confirm scope
Default **project only** (all three paths below). Ask only if they mentioned personal install:
- Project: `.cursor/skills/design-docs-template`, `.claude/skills/design-docs-template`, `.agents/skills/design-docs-template`
- Optional personal: `~/.claude/skills/design-docs-template`, `~/.agents/skills/design-docs-template`, and Cursor user/Agent Store `skills/design-docs-template` if clearly available
Do not invent other destinations.
### 3. Download and replace
From the **docs repo root** (create parent dirs if missing):
```bash
npx --yes degit <owner>/<repo>/.cursor/skills/design-docs-template /tmp/design-docs-template-skill
```
Then for each project destination:
```bash
mkdir -p .cursor/skills .claude/skills .agents/skills
rsync -a --delete /tmp/design-docs-template-skill/ .cursor/skills/design-docs-template/
rsync -a --delete /tmp/design-docs-template-skill/ .claude/skills/design-docs-template/
rsync -a --delete /tmp/design-docs-template-skill/ .agents/skills/design-docs-template/
```
If personal was requested, the same `rsync` into those home paths.
Prefer `degit` + `rsync --delete` so removed files disappear. If `degit` fails, report the error; do not half-update one tree only.
### 4. Verify
Check that each updated tree contains `SKILL.md`, `update-skills/SKILL.md`, and `README.md`. Spot-check that OpenMove vs generic flavour in `README.md` matches the source you pulled (OpenMove playbook should mention `openmove/…` in install lines).
### 5. Hand off
List paths updated and source repo. Tell them to start a **new agent chat** or `/reload` (Pi) so the runtime picks up changes. Do not commit unless they ask.
## Hard rules
- Never modify `docs/` or `website/` in this command.
- Never run this as a recursive “update then update again” loop in the same turn.
- Keep all project copies identical after the run.
- If the repo has local uncommitted edits **inside** the skill folders, warn and ask before `--delete`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |