Update Docs

Detect user-facing features in recently merged PRs and open a PR in the docs repo adding the missing documentation.

220 stars 67 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add getnao/sylph --skill update-docs
Manual install
git clone --depth 1 https://github.com/getnao/sylph.git /tmp/sylph
mkdir -p ~/.claude/skills
cp -r /tmp/sylph/.claude/skills/update-docs ~/.claude/skills/update-docs

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Update Docs

When the user runs `/update-docs`, scan recently merged PRs for user-facing
changes and open a documentation PR.

## MCP connectors

| Connector | Purpose |
|-----------|---------|
| GitHub | Read merged PRs, create docs PRs |

## Prerequisites

Both repos must be cloned locally:
- **Product repo**: the main codebase (configured in CONTEXT.md)
- **Docs repo**: the documentation site (configured in CONTEXT.md or asked on first run)

State file: `agents/cmo/_state/docs_last_refresh.txt` (plain text, single ISO date).

---

## Step 1: Determine the PR window

1. Read `agents/cmo/_state/docs_last_refresh.txt` if it exists
2. If the file exists, use its date as `SINCE`
3. If it does NOT exist (first run), use `today - 15 days` as `SINCE`
4. Record `TODAY` as the date to write back at the end

---

## Step 2: List merged PRs

```bash
gh pr list -R <product-repo> \
  --state merged \
  --search "merged:>=<SINCE>" \
  --limit 100 \
  --json number,title,url,mergedAt,body,author,files
```

Keep the full list - every PR appears in the final summary, even those that don't need docs.

---

## Step 3: Classify each PR

For each PR, decide: **user-facing or not?**

**User-facing** (needs docs):
- New feature in the UI, CLI, API, or configuration
- New command, flag, setting, integration, or UI element
- Behavior change that affects how users interact with the product
- New capability that a user would want to know about
- Anything that belongs in release notes
Read the full skill on GitHub

Details

Skill name
update-docs
Repository
getnao/sylph
Path
.claude/skills/update-docs/SKILL.md
Repo updated
21 May 2026

FAQ

What does the Update Docs skill do?

Detect user-facing features in recently merged PRs and open a PR in the docs repo adding the missing documentation.

How do I install the Update Docs skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add getnao/sylph --skill update-docs. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Update Docs popular?

It lives in getnao/sylph, which has 220 GitHub stars and 67 forks.

Related skills

Create Contract

220

getnao/sylph

Generate a customer-specific enterprise service agreement by filling in the standard template with deal details.

Marketing, Sales & Business67

Head of Data

220

getnao/sylph

Head of Data agent - creates reportings and ad-hoc analytics using nao MCP tools. Always use ask_nao to create conversations that persist in nao.

AI, LLMs & Agents67

Review Contract

220

getnao/sylph

Review a contract against standard negotiation positions - flag deviations, generate redlines, provide business impact analysis. Use when reviewing vendor or customer agreements, when you need clause-by-clause analysis, or when preparing a negotiation strategy.

Marketing, Sales & Business67

Social Media

243

aronhy/marketing-skill-hub

Grow brand accounts with organic content on TikTok, Instagram, YouTube (Shorts and long-form), Facebook, Pinterest, X, Reddit and LinkedIn for overseas markets (default US): which platform to pick, account and profile setup, content formats, posting cadence, platform search (SEO), metrics, repurposing one video across platforms, content pillars and a weekly content calendar. Use when the user asks about running social accounts, organic reach, followers, Reels, Shorts, TikTok or YouTube channels, what to post, how often, or content planning. 中文关键词: 社媒运营, 社交媒体, 自然流量, 涨粉, 账号运营, TikTok 运营, Instagr

Writing & Content41

Safe Solana Builder

149

Frankcastleauditor/safe-solana-builder

Use this skill whenever the user wants to write, scaffold, or build a Solana smart contract or program from scratch. Triggers on: "write a Solana program", "create a smart contract", "build an anchor program", "write a native Rust Solana program", "scaffold a Solana program", "help me write a program that does X on Solana", or any request to produce production-grade on-chain Solana code. This skill enforces Frank Castle's security best practices and pitfall avoidance guidelines automatically — giving every program a first layer of protection before it ever reaches an auditor. Always use this s

Writing & Content24

Copilot Docs

299

hoodini/ai-agents-skills

Configure GitHub Copilot with custom instructions. Use when setting up .github/copilot-instructions.md, customizing Copilot behavior, or creating repository-specific AI guidance. Triggers on Copilot instructions, copilot-instructions.md, GitHub Copilot config.

Writing & Content76

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.