Initial commit

Author: utsengar

.claude-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "webflow-skills",
+  "description": "Webflow-specific agent skills for Claude - CMS management, publishing, QA, and site operations",
+  "owner": {
+    "name": "Webflow",
+    "email": "developers@webflow.com"
+  },
+  "plugins": [
+    {
+      "name": "webflow-skills",
+      "description": "Skills for Webflow site management including bulk CMS updates, safe publishing, QA checks, and more",
+      "author": {
+        "name": "Webflow"
+      },
+      "source": "./plugins/webflow-skills",
+      "category": "productivity"
+    }
+  ]
+}
+

.github/workflows/ci.yml

@@ -0,0 +1,86 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint and Validate
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Check for required files
+        run: |
+          echo "Checking required files..."
+          
+          # Check root files
+          test -f README.md || (echo "Missing README.md" && exit 1)
+          test -f LICENSE || (echo "Missing LICENSE" && exit 1)
+          test -f AGENTS.md || (echo "Missing AGENTS.md" && exit 1)
+          test -L CLAUDE.md || (echo "Missing CLAUDE.md symlink" && exit 1)
+          
+          # Check marketplace config
+          test -f .claude-plugin/marketplace.json || (echo "Missing .claude-plugin/marketplace.json" && exit 1)
+          
+          # Check plugin config
+          test -f plugins/webflow-skills/.claude-plugin/plugin.json || (echo "Missing plugin.json" && exit 1)
+          
+          echo "All required files present ✓"
+
+      - name: Validate skill structure
+        run: |
+          echo "Validating skills..."
+          
+          for skill_dir in plugins/webflow-skills/skills/*/; do
+            skill_name=$(basename "$skill_dir")
+            echo "Checking skill: $skill_name"
+            
+            # Check for SKILL.md
+            test -f "${skill_dir}SKILL.md" || (echo "Missing SKILL.md in $skill_name" && exit 1)
+            
+            # Check SKILL.md has required frontmatter
+            if ! grep -q "^name:" "${skill_dir}SKILL.md"; then
+              echo "Missing 'name' in $skill_name/SKILL.md frontmatter"
+              exit 1
+            fi
+            
+            if ! grep -q "^description:" "${skill_dir}SKILL.md"; then
+              echo "Missing 'description' in $skill_name/SKILL.md frontmatter"
+              exit 1
+            fi
+            
+            echo "  ✓ $skill_name valid"
+          done
+          
+          echo "All skills validated ✓"
+
+  count-skills:
+    name: Count Skills
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Count and list skills
+        run: |
+          echo "## Skills in Repository" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          
+          count=0
+          for skill_dir in plugins/webflow-skills/skills/*/; do
+            if [ -f "${skill_dir}SKILL.md" ]; then
+              skill_name=$(basename "$skill_dir")
+              echo "- $skill_name" >> $GITHUB_STEP_SUMMARY
+              count=$((count + 1))
+            fi
+          done
+          
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Total: $count skills**" >> $GITHUB_STEP_SUMMARY

.gitignore

@@ -0,0 +1,31 @@
+# Dependencies
+node_modules/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Build outputs
+dist/
+build/
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+

AGENTS.md

@@ -0,0 +1,68 @@
+# Webflow Skills
+
+You have access to skills for working with Webflow sites through the Webflow MCP server.
+
+## Available Skills
+
+### Content Operations
+- **bulk-cms-update**: Create or update multiple CMS items with validation
+- **cms-collection-setup**: Create new collections from schema definitions
+- **page-content-update**: Update page metadata safely
+
+### Quality Assurance
+- **pre-publish-qa**: Check for issues before publishing
+- **seo-metadata-check**: Audit SEO metadata across pages
+
+### Publishing
+- **safe-publish**: Plan → Confirm → Publish workflow
+
+### Site Management
+- **site-inventory**: Export site structure
+- **site-diagnostics**: Troubleshoot issues
+- **asset-audit**: Analyze assets
+- **custom-code-management**: Manage scripts and tracking code
+
+## Safety Rules
+
+Always follow these patterns when working with Webflow:
+
+1. **Preview before modifying**: Show what will change before making changes
+2. **Require confirmation for destructive actions**: Publishing, deleting, bulk updates
+3. **Process in batches**: Chunk large operations (50 items max per batch)
+4. **Report what changed**: Provide clear audit trails
+
+## Response Format
+
+### For Read Operations
+```
+📊 [Title]: [Site Name]
+
+[Findings organized by category]
+[Tables for structured data]
+[✅ or ⚠️ indicators for status]
+```
+
+### For Write Operations
+```
+📋 Preview: [Operation]
+
+[What will change]
+
+⚠️ Type "[confirm]" to proceed.
+```
+
+### After Changes
+```
+✅ [Operation] Complete
+
+[Summary of changes]
+[Affected items]
+```
+
+## Error Handling
+
+When errors occur:
+1. Explain what went wrong
+2. Suggest recovery steps
+3. Report partial successes separately from failures
+

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

CONTRIBUTING.md

@@ -0,0 +1,76 @@
+# Contributing
+
+Guidelines for adding and improving Webflow skills.
+
+## Adding a New Skill
+
+### 1. Create the Skill Directory
+
+```
+plugins/webflow-skills/skills/
+└── my-skill/
+    └── SKILL.md
+```
+
+### 2. Write SKILL.md
+
+Use YAML frontmatter followed by markdown content:
+
+```markdown
+---
+name: my-skill
+description: Clear description of what this skill does and when to use it. Include keywords that help agents identify when this skill is relevant.
+---
+
+# My Skill Name
+
+## Instructions
+
+Step-by-step guidance for the agent.
+
+## Examples
+
+Concrete examples showing expected input/output.
+
+## Guidelines
+
+- Specific rules to follow
+- Edge cases to handle
+```
+
+### Naming Conventions
+
+- `name`: 1-64 characters, lowercase alphanumeric with hyphens only
+- `description`: Up to 1024 characters, include trigger keywords
+- Keep `SKILL.md` under 500 lines
+
+### Optional Fields
+
+```yaml
+---
+name: my-skill
+description: What this skill does
+license: MIT
+model: sonnet
+allowed-tools: Read Grep Glob
+---
+```
+
+## Quality Checklist
+
+- [ ] `SKILL.md` has name and description in frontmatter
+- [ ] Instructions section explains how to perform the task
+- [ ] Examples show realistic prompts and responses
+- [ ] Guidelines cover edge cases
+
+## Pull Requests
+
+1. Test the skill with Claude
+2. Title format: `feat(skills): Add [skill-name]`
+3. Explain what the skill does and why
+
+## Issues
+
+**Bug reports**: Skill name, steps to reproduce, expected vs actual
+
+**Feature requests**: Proposed skill, use case, expected behavior

LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Webflow, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+