diff --git a/.vibe/skills/skill_creator/scripts/validate_skill.sh b/.vibe/skills/skill_creator/scripts/validate_skill.sh
index 2dc8220..c5b4846 100755
--- a/.vibe/skills/skill_creator/scripts/validate_skill.sh
+++ b/.vibe/skills/skill_creator/scripts/validate_skill.sh
@@ -40,13 +40,13 @@ if [[ "$SKILL_NAME" == -* ]] || [[ "$SKILL_NAME" == *- ]]; then
 fi
 
 # Check name doesn't contain consecutive hyphens
-if echo "$SKILL_NAME" | grep -q "--"; then
+if echo "$SKILL_NAME" | grep -q -e "--"; then
     echo "ERROR: Skill name cannot contain consecutive hyphens"
     exit 1
 fi
 
 # Check description length (1-1024 characters)
-DESCRIPTION=$(grep -A 1 "^description:" "$1/SKILL.md" | tail -1 | tr -d ' ')
+DESCRIPTION=$(grep "^description:" "$1/SKILL.md" | cut -d " " -f 2-)
 DESCRIPTION_LENGTH=${#DESCRIPTION}
 
 if [ "$DESCRIPTION_LENGTH" -lt 1 ] || [ "$DESCRIPTION_LENGTH" -gt 1024 ]; then
diff --git a/README.md b/README.md
index 42aeb59..5baac99 100644
--- a/README.md
+++ b/README.md
@@ -271,6 +271,56 @@ This project uses Architecture Decision Records (ADRs) to document key technical
 
 **Adding new decisions?** See [adr/README.md](adr/README.md) for guidelines.
 
+## Gitea Integration
+
+DanceLessonsCoach includes AI agent skills for Gitea integration to monitor CI/CD jobs and interact with pull requests.
+
+### Gitea Client Skill Setup
+
+The Gitea client skill enables AI agents to:
+- Monitor CI/CD job status
+- Fetch job logs for debugging
+- Comment on pull requests
+- Track PR status
+
+**Setup Instructions:**
+
+1. **Create a Personal Access Token:**
+   - Log in to https://gitea.arcodange.lab
+   - Go to Profile → Settings → Applications
+   - Generate token with `read:repository`, `write:repository`, and `read:user` scopes
+
+2. **Configure Authentication:**
+   ```bash
+   # Option 1: Environment variable
+   export GITEA_API_TOKEN="your_token"
+   
+   # Option 2: Token file (recommended)
+   echo "your_token" > ~/.gitea_token
+   chmod 600 ~/.gitea_token
+   export GITEA_API_TOKEN_FILE="$HOME/.gitea_token"
+   ```
+
+3. **Add to shell configuration:**
+   ```bash
+   echo 'export GITEA_API_TOKEN_FILE="$HOME/.gitea_token"' >> ~/.bashrc
+   source ~/.bashrc
+   ```
+
+**Usage Examples:**
+```bash
+# List recent jobs
+.vibe/skills/gitea-client/scripts/gitea-client.sh list-jobs owner repo workflow_id 5
+
+# Wait for job completion
+.vibe/skills/gitea-client/scripts/gitea-client.sh wait-job owner repo job_id 300
+
+# Comment on PR
+.vibe/skills/gitea-client/scripts/gitea-client.sh comment-pr owner repo 42 "Build completed!"
+```
+
+**Documentation:** See [.vibe/skills/gitea-client/README.md](.vibe/skills/gitea-client/README.md) for complete setup and usage guide.
+
 ## License
 
 MIT