refactor: reorganize repo docs and tooling layout

Consolidate the repository into clearer apps, tools, and layered docs areas so contributors can navigate and maintain it more reliably. Align validation, metadata sync, and CI around the same canonical workflow to reduce drift across local checks and GitHub Actions.

docs/contributors/skill-template.md

@@ -0,0 +1,65 @@
+---
+name: your-skill-name
+description: "Brief one-sentence description of what this skill does (under 200 characters)"
+category: your-category
+risk: safe
+source: community
+date_added: "YYYY-MM-DD"
+author: your-name-or-handle
+tags: [tag-one, tag-two]
+tools: [claude, cursor, gemini]
+---
+
+# Skill Title
+
+## Overview
+
+A brief explanation of what this skill does and why it exists.
+2-4 sentences is perfect.
+
+## When to Use This Skill
+
+- Use when you need to [scenario 1]
+- Use when working with [scenario 2]
+- Use when the user asks about [scenario 3]
+
+## How It Works
+
+### Step 1: [Action]
+
+Detailed instructions...
+
+### Step 2: [Action]
+
+More instructions...
+
+## Examples
+
+### Example 1: [Use Case]
+
+\`\`\`javascript
+// Example code
+\`\`\`
+
+### Example 2: [Another Use Case]
+
+\`\`\`javascript
+// More code
+\`\`\`
+
+## Best Practices
+
+- ✅ Do this
+- ✅ Also do this
+- ❌ Don't do this
+- ❌ Avoid this
+
+## Common Pitfalls
+
+- **Problem:** Description
+  **Solution:** How to fix it
+
+## Related Skills
+
+- `@other-skill` - When to use this instead
+- `@complementary-skill` - How this works together