From 7685c4dd1a33a0eb2bd54bb18ac68687811c8317 Mon Sep 17 00:00:00 2001 From: Albert Chang Date: Thu, 4 Jun 2026 12:01:05 -0700 Subject: [PATCH] docs(DEVPL-4732): add skill-authoring guidance, CONTRIBUTING.md as source of truth MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Make it easy for internal and external contributors to build skills correctly and reduce churn on "how do I write a skill?" - CONTRIBUTING.md: new "Designing skills (start here)" section (Anthropic skill guide + skill-creator) — the single source of truth - CLAUDE.md: point authors at that section (AGENTS.md symlinks to CLAUDE.md; no duplicated content) - README.md: add a Contributing section linking CONTRIBUTING.md (README had no contributing link) Co-Authored-By: Claude Opus 4.8 (1M context) --- CLAUDE.md | 2 +- CONTRIBUTING.md | 11 ++++++++++- README.md | 4 ++++ 3 files changed, 15 insertions(+), 2 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 14706f8..d451944 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -60,4 +60,4 @@ Optional frontmatter: `license`, `model`, `allowed-tools` ## Adding/Editing Skills -Follow `CONTRIBUTING.md`. PR title format: `feat(skills): Add [skill-name]`. Keep SKILL.md under 500 lines. Every skill needs Instructions, Examples, and Guidelines sections. +Before authoring or editing a skill, read `CONTRIBUTING.md` — especially **Designing skills (start here)**, which links Anthropic's skill-design guide and the `skill-creator` skill. PR title format: `feat(skills): Add [skill-name]`. Keep SKILL.md under 500 lines. Every skill needs Instructions, Examples, and Guidelines sections. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 750ca7f..7242a22 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,15 @@ # Contributing -Guidelines for adding and improving Webflow skills. +Guidelines for adding and improving Webflow skills. Internal and external contributions are both welcome. + +## Designing skills (start here) + +New to writing skills? Use Anthropic's guidance and tooling before you start — it's the fastest way to get a skill right the first time: + +- **[The Complete Guide to Building Skills for Claude](https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf)** — how to scope, structure, and name a skill, write descriptions with strong trigger keywords, apply progressive disclosure, and include effective examples. +- **[`skill-creator` skill](https://github.com/anthropics/skills/blob/main/skills/skill-creator)** — install it and let it scaffold and refine your `SKILL.md` instead of starting from a blank file. + +Then follow the structure and conventions below. ## Adding a New Skill diff --git a/README.md b/README.md index 413144c..94844d4 100644 --- a/README.md +++ b/README.md @@ -111,6 +111,10 @@ All skills ship from the single `webflow-skills` plugin. - [Available Tools](https://developers.webflow.com/mcp/v1.0.0/reference/how-it-works#available-tools) - Complete tool reference - [Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) - Learn about the Agent Skills standard +## Contributing + +Internal and external contributions are both welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) — it covers how to design a skill (Anthropic's skill-design guide + the `skill-creator` skill), the `SKILL.md` structure and conventions, and the pull request process. + ## License MIT