Initial commit

2025-11-29 18:00:50 +08:00
commit c5931553a6
106 changed files with 49995 additions and 0 deletions
--- a/commands/workspace/update-about.md
+++ b/commands/workspace/update-about.md
@@ -0,0 +1,124 @@
+---
+name: workspace:update-about
+description: Update GitHub About section with SEO-optimized description, topics, and links
+delegates-to: autonomous-agent:documentation-generator
+---
+
+# Workspace Update-About Command
+
+## Command: `/workspace:update-about`
+
+**GitHub About section optimization** - Updates the repository's About section (description, topics, website) on GitHub with current project information and optimizes for search and discovery.
+
+**🏷️ About Section Management:**
+- **Description Update**: Concise, accurate project description
+- **Topic Optimization**: Relevant tags for discoverability
+- **Website Link**: Updates project website if available
+- **SEO Optimization**: Optimizes for GitHub search
+- **Keyword Strategy**: Uses effective keywords
+- **Consistency**: Matches README and documentation
+
+## Usage
+
+```bash
+# Basic update (analyzes and updates)
+/workspace:update-about
+
+# With custom description
+/workspace:update-about --description "AI-powered autonomous development plugin for Claude Code"
+
+# Add/update topics
+/workspace:update-about --add-topics "ai,automation,claude,agents"
+
+# SEO focus
+/workspace:update-about --seo-optimize
+
+# Complete refresh
+/workspace:update-about --refresh-all
+```
+
+## How It Works
+
+1. **Current State Analysis**
+   - Reads current About section via GitHub API
+   - Analyzes current description and topics
+   - Reviews project for accurate information
+
+2. **Content Generation**
+   - Generates concise description (max 350 chars)
+   - Identifies relevant topics/tags
+   - Optimizes for GitHub search
+   - Ensures accuracy and clarity
+
+3. **SEO Optimization**
+   - Includes key searchable terms
+   - Uses popular relevant topics
+   - Balances specificity and discoverability
+   - Follows GitHub best practices
+
+4. **Update Execution**
+   - Updates via GitHub API (requires token)
+   - Validates changes
+   - Preserves manual customizations if requested
+
+## Output Format
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🏷️  ABOUT SECTION UPDATED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Description (Updated):
+"Autonomous AI agents for Claude Code with pattern learning,
+quality control, and full-stack validation. Zero-config,
+intelligent development automation."
+
+Topics (Added 3):
+artificial-intelligence, automation, code-quality,
+pattern-learning, autonomous-agents, claude-code
+
+SEO Score: 92/100
+- Keywords: 8 high-value terms [PASS]
+- Topic relevance: 95% [PASS]
+- Discoverability: High [PASS]
+
+[PASS] Updated on GitHub successfully
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Requirements
+
+- GitHub personal access token with repo permissions
+- Set in environment variable: `GITHUB_TOKEN`
+- Repository must be on GitHub (GitLab support coming)
+
+## Best Practices
+
+### Description Guidelines
+- Keep under 350 characters
+- Lead with main benefit/purpose
+- Include key features/differentiators
+- Use searchable keywords naturally
+- Avoid jargon unless necessary
+
+### Topic Selection
+- Use 5-10 relevant topics
+- Mix general and specific terms
+- Include language/framework tags
+- Add domain-specific terms
+- Check GitHub's suggested topics
+
+### SEO Optimization
+- Include primary keywords in description
+- Use popular, relevant topics
+- Match common search terms
+- Balance specificity and breadth
+- Monitor GitHub search results
+
+---
+
+**Version**: 1.0.0
+**Delegates-to**: documentation-generator agent
+**Requires**: GitHub API access (GITHUB_TOKEN)
+**Platform**: GitHub (GitLab support planned)
+**SEO**: Optimized for GitHub discovery