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