From 0215a8b7df65f8e5d0d18fbc617039c418c18f97 Mon Sep 17 00:00:00 2001
From: Gabriel Radureau <arcodange@gmail.com>
Date: Mon, 6 Apr 2026 12:34:57 +0200
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs:=20update=20README=20with?=
 =?UTF-8?q?=20Gitea=20setup=20and=20fix=20skill=20validation?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Update project README.md:

- Add Gitea Integration section

- Document Gitea client skill setup instructions

- Provide usage examples for monitoring CI/CD jobs

Fix skill creator validation script:

- Fix grep command for consecutive hyphens check

- Fix description extraction logic

- Improve error handling for skill validation

These changes support the new Gitea client skill and improve

the skill creation/validation workflow.
---
 .../skill_creator/scripts/validate_skill.sh   |  4 +-
 README.md                                     | 50 +++++++++++++++++++
 2 files changed, 52 insertions(+), 2 deletions(-)

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