From eb9b84daa419c77c73a41f6f9a7b51e830d6421e Mon Sep 17 00:00:00 2001 From: Yogesh Rao Date: Thu, 4 Jun 2026 16:20:03 +0530 Subject: [PATCH] =?UTF-8?q?feat:=20improve=20project-dev=20skill=20score?= =?UTF-8?q?=20(78%=20=E2=86=92=2097%)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hey @Simon-McIntosh 👋 I ran your skills through `tessl skill review` at work and found some targeted improvements for `project-dev`. Here's the full before/after: | Skill | Before | After | Change | |-------|--------|-------|--------| | project-dev | 78% | 97% | +19% | | service-ops | 87% | 87% | — | | plan-execution | 70% | 70% | — |
What changed in project-dev - **Description**: Replaced generic terms ("develop, test, lint, build") with specific tool names (`pytest`, `ruff`, `LinkML`) and added trigger terms (`formatting`, `CI`, `generated models`) — description score jumped from 67% to 100% - **Git workflow**: Added a lint → format → test validation sequence before staging and committing, addressing the missing feedback loop the reviewer flagged — workflow clarity went from 2/3 to 3/3 - **No structural rewrites**: kept the existing content intact, just made the description more discoverable and the git workflow more explicit
I also stress-tested your `service-ops` skill against a few real-world task evals and it held up really well on multi-service SLURM orchestration with Neo4j + embedding server startup sequencing. Kudos for that. Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch — just saw room for improvement and wanted to contribute. Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at [this Tessl guide](https://docs.tessl.io/evaluate/optimize-a-skill-using-best-practices) and ask it to optimize your skill. Ping me — [@yogesh-tessl](https://github.com/yogesh-tessl) — if you hit any snags. Thanks in advance 🙏 --- .github/skills/project-dev/SKILL.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/.github/skills/project-dev/SKILL.md b/.github/skills/project-dev/SKILL.md index 28b5e2d0..24f235ee 100644 --- a/.github/skills/project-dev/SKILL.md +++ b/.github/skills/project-dev/SKILL.md @@ -1,6 +1,6 @@ --- name: project-dev -description: How to develop, test, lint, and build the imas-codex project. Use when making code changes, running tests, or building the project. +description: "How to run pytest, ruff linting, and LinkML schema builds for the imas-codex Python project. Use when writing code, running tests, formatting, checking CI, or rebuilding generated models." --- # imas-codex Development @@ -51,9 +51,12 @@ uv sync --extra gpu # Include GPU deps (for embedding) ## Git Workflow ```bash -git add # Stage specific files only -uv run git commit -m 'type: concise summary' # Conventional commit -git pull --no-rebase origin main # Always merge, never rebase +uv run ruff check --fix . # 1. Lint + autofix +uv run ruff format . # 2. Format +uv run pytest tests/path/to/changed_test.py -q # 3. Verify changes pass +git add # 4. Stage specific files only +uv run git commit -m 'type: concise summary' # 5. Conventional commit +git pull --no-rebase origin main # 6. Always merge, never rebase git push origin main ```