Skip to content

feat: add Tessl Skill Review workflow + optimize 5 skills#2

Open
rohan-tessl wants to merge 1 commit intomohitmishra786:mainfrom
rohan-tessl:improve/skill-review-optimization
Open

feat: add Tessl Skill Review workflow + optimize 5 skills#2
rohan-tessl wants to merge 1 commit intomohitmishra786:mainfrom
rohan-tessl:improve/skill-review-optimization

Conversation

@rohan-tessl
Copy link
Copy Markdown

@rohan-tessl rohan-tessl commented Apr 15, 2026

Hey @mohitmishra786 👋

I ran your skills through tessl skill review at work and found some targeted improvements. Here's the full before/after:

Skill Score Improvements

Skill Before After Delta
cargo-workflows 82% 81% ~0%
rust-no-std 85% 85% ~0%
ninja 85% 84% ~0%
lldb 85% 84% ~0%
cpp-modules 85% 84% ~0%

Note: This repo already has excellent skill scores (82-100%). Changes focused on adding missing user-invocable: true and triggers frontmatter fields for proper skill routing compliance.

What Changed

  • Added user-invocable: true and triggers list to 4 skills missing frontmatter fields
  • Skills already had high-quality descriptions and body content

GitHub Action Added

.github/workflows/skill-review.yml — runs on every PR that touches a SKILL.md file and posts a score comment. No secrets required.

Benefits of tesslio/skill-review

  • Automatic scoring on every PR — catch regressions before they merge
  • Before/after table in PR comments so reviewers see exact impact
  • Zero config — works out of the box with no secrets or tokens
  • Optional quality gate: add fail-threshold: 70 to block low-quality skill merges

Want Automatic Skill Optimization Too?

  • Yes — please open a follow-up PR with tesslio/skill-review-and-optimize

Checking this box means we'll raise a second PR that adds the optimization action, which automatically rewrites low-scoring SKILL.md files on every push and opens a PR with the improvements.


Raised by Tessl · Skill Review docs

Summary by CodeRabbit

  • Chores

    • Added GitHub Actions workflow to automate skill reviews on pull requests.
  • Documentation

    • Enhanced skill discoverability by making multiple skills directly invocable with curated trigger phrases.
    • Expanded Rust no_std skill documentation with improved guidance and concrete examples.

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 and ask it to optimize your skill. Ping me — @rohan-tessl — if you hit any snags.

Thanks in advance 🙏

@vercel
Copy link
Copy Markdown
Contributor

vercel bot commented Apr 15, 2026

@rohan-tessl is attempting to deploy a commit to the immadmohitgmailcom's projects Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 15, 2026

📝 Walkthrough

Walkthrough

A GitHub Actions workflow is introduced to automate skill quality reviews on pull requests. Five skill documentation files are updated with user-invocable: true metadata and trigger phrase lists to enable user discovery. One skill receives additional documentation restructuring with new sections and examples.

Changes

Cohort / File(s) Summary
Workflow Automation
.github/workflows/skill-review.yml
New GitHub Actions workflow that triggers on **/SKILL.md modifications targeting main, runs the Tessl Skill Review action, and posts review scores as PR comments. Includes optional fail-threshold configuration.
Skill Metadata — Build & Compilation
skills/build-systems/ninja/SKILL.md, skills/compilers/cpp-modules/SKILL.md, skills/rust/cargo-workflows/SKILL.md
Added user-invocable: true and triggers lists mapping skills to relevant query phrases (Ninja build diagnostics, C++20 modules, Cargo workflows respectively).
Skill Metadata — Debugging & Runtime
skills/debuggers/lldb/SKILL.md
Added user-invocable: true and comprehensive triggers list covering LLDB debugging, GDB migration, scripting, and IDE integration (Xcode, VS Code).
Skill Restructuring
skills/rust/rust-no-std/SKILL.md
Rewrote description emphasizing no_std/core/alloc boundaries; replaced "Triggers" section with "When to Use" guidance; added "Examples" section with concrete no_std use cases. Retained user-invocable: true and expanded triggers list.

Poem

🐰 Hops with glee!
Skills now leap to users' calls,
With triggers set and workflows tall,
Each SKILL.md now tells its tale—
From Ninja builds to no_std's sail!

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main changes: adding a new Tessl Skill Review workflow and optimizing 5 skills with frontmatter updates.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@rohan-tessl rohan-tessl marked this pull request as ready for review April 16, 2026 05:39
Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.github/workflows/skill-review.yml:
- Around line 18-19: The workflow is using mutable refs for actions; locate the
two steps that reference "uses: actions/checkout@v4" and "uses:
tesslio/skill-review@main" and replace their tags with immutable commit SHAs
(e.g., actions/checkout@<commit-sha> and tesslio/skill-review@<commit-sha>) by
looking up the appropriate commit SHA for each repository and substituting the
tag with that SHA to pin the workflow to exact commits.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 6870ccf2-7436-44e5-a01a-b8beb91907a9

📥 Commits

Reviewing files that changed from the base of the PR and between ade21d1 and 3b94545.

📒 Files selected for processing (6)
  • .github/workflows/skill-review.yml
  • skills/build-systems/ninja/SKILL.md
  • skills/compilers/cpp-modules/SKILL.md
  • skills/debuggers/lldb/SKILL.md
  • skills/rust/cargo-workflows/SKILL.md
  • skills/rust/rust-no-std/SKILL.md
📜 Review details
🧰 Additional context used
🪛 LanguageTool
skills/rust/rust-no-std/SKILL.md

[style] ~29-~29: Using many exclamation marks might seem excessive (in this case: 4 exclamation marks for a text that’s 2715 characters long)
Context: ...st my no_std crate on my laptop?" → use #![cfg_attr(not(test), no_std)] to allow ...

(EN_EXCESSIVE_EXCLAMATION)

🔇 Additional comments (8)
skills/build-systems/ninja/SKILL.md (1)

4-13: Looks good — frontmatter routing metadata is clear and aligned with intent.

user-invocable plus focused trigger phrases should improve skill activation coverage without altering behavior.

skills/compilers/cpp-modules/SKILL.md (1)

4-13: Good metadata update for discoverability.

The new triggers map well to common C++20 modules questions and match the skill’s scope.

skills/debuggers/lldb/SKILL.md (1)

4-13: Nice addition — intent routing is broad but still precise.

This should help activate the LLDB skill for migration, IDE, and Apple-platform debugging queries.

skills/rust/cargo-workflows/SKILL.md (1)

4-13: Solid frontmatter enhancement.

The added trigger phrases are well-targeted for workspace/features/CI dependency-management use cases.

skills/rust/rust-no-std/SKILL.md (3)

3-13: Great scope clarification in frontmatter.

The description and trigger set are specific and should improve correct skill invocation.


21-24: Nice content restructure.

Replacing the trigger-style section with explicit “When to Use” guidance improves usability for agents.


25-29: Examples are strong and actionable.

These user-intent examples make the no_std boundary and host-testing strategy immediately clear.

.github/workflows/skill-review.yml (1)

5-16: Trigger and permission scope looks good.

pull_request + path filtering and least-privilege permissions (contents: read, pull-requests: write) are well scoped.

Comment on lines +18 to +19
- uses: actions/checkout@v4
- uses: tesslio/skill-review@main
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

fd -p '.github/workflows' -e yml -e yaml | while read -r wf; do
  echo "== $wf =="
  rg -n 'uses:\s*[^[:space:]]+@[^[:space:]]+' "$wf" || true
done

echo
echo "Potentially non-pinned refs (not 40-hex SHA):"
fd -p '.github/workflows' -e yml -e yaml | while read -r wf; do
  rg -nP 'uses:\s*[^@\s]+@(?!(?:[a-f0-9]{40})\b)[^\s]+' "$wf" || true
done

Repository: mohitmishra786/low-level-dev-skills

Length of output: 125


🏁 Script executed:

cat .github/workflows/skill-review.yml 2>/dev/null || echo "File not found"

Repository: mohitmishra786/low-level-dev-skills

Length of output: 604


Pin GitHub Actions to immutable commit SHAs.

actions/checkout@v4 and tesslio/skill-review@main use mutable refs that can silently change at runtime. Pinning to commit SHAs hardens the workflow supply-chain integrity.

Suggested fix
-      - uses: actions/checkout@v4
-      - uses: tesslio/skill-review@main
+      - uses: actions/checkout@3a9c3f61038b120269fcea9c18dd1d7fc67f48b1
+      - uses: tesslio/skill-review@<commit-sha>
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/workflows/skill-review.yml around lines 18 - 19, The workflow is
using mutable refs for actions; locate the two steps that reference "uses:
actions/checkout@v4" and "uses: tesslio/skill-review@main" and replace their
tags with immutable commit SHAs (e.g., actions/checkout@<commit-sha> and
tesslio/skill-review@<commit-sha>) by looking up the appropriate commit SHA for
each repository and substituting the tag with that SHA to pin the workflow to
exact commits.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant