From 07db6167fffd4007352fc66e4340206228a324b3 Mon Sep 17 00:00:00 2001 From: rohan-tessl Date: Thu, 16 Apr 2026 10:57:48 +0530 Subject: [PATCH] =?UTF-8?q?feat:=20improve=20skill=20score=20for=20Text-Le?= =?UTF-8?q?gend=20(71%=20=E2=86=92=2095%)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hey @e5sub 👋 I ran your skills through `tessl skill review` at work and found some targeted improvements. Here's the full before/after: | Skill | Before | After | Change | |-------|--------|-------|--------| | text-legend-openclaw-deploy | 71% | 95% | +24% | Changes made: - Fixed UTF-8 BOM at start of file that was breaking frontmatter detection - Enhanced description with explicit "Use when..." clause and broader trigger terms - Removed redundant '触发场景' section to save tokens - Added health check verification with curl commands and troubleshooting feedback loop - Improved workflow clarity with validation gates and clear MySQL vs SQLite branching - Translated section headers to English for broader discoverability Honest disclosure — I work at @tesslio where we build tooling around skills like these. --- SKILL.md | 111 ++++++++++++++++++++++++------------------------------- 1 file changed, 48 insertions(+), 63 deletions(-) diff --git a/SKILL.md b/SKILL.md index fe2db96..5fc5c27 100644 --- a/SKILL.md +++ b/SKILL.md @@ -1,113 +1,98 @@ ---- +--- name: text-legend-openclaw-deploy -description: Install OpenClaw/Skillhub (if needed) and deploy Text-Legend with Docker Compose (MySQL/SQLite), including start/stop and health checks. +description: "Set up, deploy, and manage Text-Legend game server using Docker Compose with MySQL or SQLite. Handles OpenClaw/Skillhub installation, container orchestration, database configuration, service health checks, and local Node.js development. Use when the user wants to run, start, stop, or troubleshoot Text-Legend services." metadata: {"clawdbot":{"requires":{"anyBins":["docker"]},"os":["win32","linux","darwin"]}} --- -# Text-Legend OpenClaw 部署技能 - -本技能用于在本仓库中自动化部署与运行 Text-Legend。覆盖以下任务： - -- 安装 OpenClaw/Skillhub（仅在用户明确要求时） -- 检查 Docker 与 Compose 环境 -- 填充 `docker-compose.mysql.yml` 的数据库配置 -- 启动与停止服务 -- 基本访问验证与日志查看 -- 本地 npm 运行（非 Docker） +# Text-Legend Deployment Skill -## 触发场景 +Automate deployment and management of Text-Legend in this repository. -- 用户希望用 OpenClaw 自动部署/运行本项目 -- 用户需要一键启动（MySQL 或 SQLite） -- 用户需要标准化的启动/停止/日志命令 +## Workflow -## 操作流程 +### 1. Install OpenClaw/Skillhub (only when user explicitly requests) -### 1. 安装 OpenClaw/Skillhub（仅在用户要求时） - -如果用户明确要安装 OpenClaw 生态或 Skillhub，提供以下命令并提醒会下载远程脚本： +Warn the user that this downloads and runs a remote script before executing: ```bash +# Full install curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -``` -仅安装 CLI： - -```bash +# CLI only curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only ``` -安装后提醒用户重启 OpenClaw 以加载 Skillhub。 +Remind the user to restart OpenClaw after installation to load Skillhub. -### 2. 环境检查 - -确认 Docker 可用： +### 2. Verify Docker Environment ```bash docker version docker compose version ``` -若 `docker compose` 不存在，提示用户升级 Docker Desktop 或安装 Compose 插件。 +If `docker compose` is missing, prompt the user to upgrade Docker Desktop or install the Compose plugin. Do not proceed until both commands succeed. + +### 3. Configure Database and Admin Account -### 3. 配置数据库与后台账号 +Edit `docker-compose.mysql.yml` with the required environment variables: -编辑 `docker-compose.mysql.yml`，填入以下环境变量： +- `DB_HOST`, `DB_USER`, `DB_PASSWORD`, `DB_NAME` +- `ADMIN_BOOTSTRAP_SECRET`, `ADMIN_BOOTSTRAP_USER` -- `DB_HOST` -- `DB_USER` -- `DB_PASSWORD` -- `DB_NAME` -- `ADMIN_BOOTSTRAP_SECRET` -- `ADMIN_BOOTSTRAP_USER` +If the user does not have MySQL, use the SQLite path (step 4b). -若用户没有 MySQL，改用 SQLite 流程： +### 4. Start Services + +**4a. MySQL:** ```bash -docker compose up --build +docker compose -f docker-compose.mysql.yml up -d ``` -### 4. 启动服务（MySQL） +**4b. SQLite:** ```bash -docker compose -f docker-compose.mysql.yml up -d +docker compose up --build ``` -### 5. 访问验证 +### 5. Verify Deployment -- 游戏：`http://localhost:3000/` -- 后台：`http://localhost:3000/admin/` +Run a health check to confirm the service is responding: -### 6. 常用运维 +```bash +curl -sf http://localhost:3000/ -o /dev/null && echo "Game server: OK" || echo "Game server: FAILED" +curl -sf http://localhost:3000/admin/ -o /dev/null && echo "Admin panel: OK" || echo "Admin panel: FAILED" +``` -- 查看日志：`docker logs -f text-legend` -- 停止服务：`docker compose -f docker-compose.mysql.yml down` +If either check fails: -### 7. 本地 npm 运行（非 Docker） +1. Check container status: `docker compose ps` +2. Review logs: `docker logs -f text-legend` +3. Common issues: port 3000 already in use, missing environment variables, database connection refused. -前置条件： +### 6. Operations -- Node.js 24+（建议 LTS） -- 可用的 SQLite 或 MySQL +- View logs: `docker logs -f text-legend` +- Stop (MySQL): `docker compose -f docker-compose.mysql.yml down` +- Stop (SQLite): `docker compose down` -步骤： +### 7. Local Node.js Development (non-Docker) + +Prerequisites: Node.js 24+ (LTS recommended), SQLite or MySQL available. ```bash npm install node src/index.js ``` -若使用 MySQL，确保已通过环境变量提供连接信息（`DB_CLIENT=mysql` 等）。 -若使用 SQLite，建议设置： - -- `DB_CLIENT=sqlite` -- `DB_FILENAME=/app/data/game.sqlite`（可按本地路径调整） -- `DB_POOL_MAX=1` +For MySQL, set connection variables (`DB_CLIENT=mysql`, `DB_HOST`, etc.). +For SQLite, set: `DB_CLIENT=sqlite`, `DB_FILENAME=./data/game.sqlite`, `DB_POOL_MAX=1`. -默认端口：`3000`。 +Default port: `3000`. -## 注意事项 +## Important -- 仅在用户明确授权时运行远程安装脚本。 -- 不要在日志或输出中泄漏数据库密码或 GM 密钥。 -- 如需持久化数据，请确认 `./data` 已挂载并可写。 +- Only run remote install scripts when the user explicitly authorizes it. +- Never expose database passwords or GM keys in logs or output. +- For data persistence, confirm `./data` is mounted and writable.