Files
gh-bejranonda-llm-autonomou…/commands/workspace/update-about.md
2025-11-29 18:00:50 +08:00

3.7 KiB

name, description, delegates-to
name description delegates-to
workspace:update-about Update GitHub About section with SEO-optimized description, topics, and links 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

# 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