feat: improve skill scores and add automated review - #1944
Conversation
Optimized 5 agent skills using tessl skill review: | Skill | Before | After | Change | |-------|--------|-------|--------| | tari-ootle-cc (claude-code) | 17% | 90% | +73% | | github-copilot | 50% | 90% | +40% | | aider | 53% | 90% | +37% | | amp | 53% | 90% | +37% | | antigravity | 53% | 90% | +37% | Changes: - Expanded frontmatter descriptions with specific actions, trigger terms, and "Use when..." clauses (Description: 7%→100% for most skills) - Renamed claude-code skill to tari-ootle-cc to avoid reserved word validation failure (was scoring 17% due to hard fail) - Tightened overview definitions for conciseness - Removed redundant ERC-20/ERC-721 comparisons
Hey @sdbondi 👋 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 | |-------|--------|-------|--------| | tari-ootle-cc (claude-code) | 17% | 90% | +73% | | github-copilot | 50% | 90% | +40% | | aider | 53% | 90% | +37% | | amp | 53% | 90% | +37% | | antigravity | 53% | 90% | +37% | Changes: - Expanded frontmatter descriptions with specific actions and trigger terms - Renamed claude-code skill to tari-ootle-cc (reserved word fix) - Tightened overview definitions for conciseness - Removed redundant ERC-20/ERC-721 comparisons - Added .github/workflows/skill-review.yml for automated skill review
|
If you're new to commit signing, there are different ways to set it up: Sign commits with
|
There was a problem hiding this comment.
Code Review
This pull request standardizes and streamlines the documentation for various Tari Ootle development skills, including Aider, Amp, Antigravity, Claude Code, and GitHub Copilot. The changes include updating descriptions to be more comprehensive, simplifying key concept definitions, and removing redundant introductory text. Feedback across all files suggests restoring the safety guarantee description ('Cannot be copied or accidentally destroyed') for the Resource concept to ensure developers understand the fundamental asset safety principles of the platform.
| - **Transaction** — A set of instructions (CallFunction, CallMethod, etc.) that are signed, submitted, and executed atomically. | ||
| - **Template** — Rust module annotated with `#[template]`; defines logic and state. Compiled to WASM and deployed. | ||
| - **Component** — Live instance of a template on-chain. Holds state and exposes public methods. | ||
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. |
There was a problem hiding this comment.
While simplifying the key concepts is good, removing the phrase 'Cannot be copied or accidentally destroyed' for Resource might omit a crucial piece of information. This is a fundamental principle of resource-oriented programming and is important for developers to understand the asset safety guarantees of the platform. I'd suggest re-adding it for clarity.
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. | |
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. Cannot be copied or accidentally destroyed. |
| - **Transaction** — A set of instructions (CallFunction, CallMethod, etc.) that are signed, submitted, and executed atomically. | ||
| - **Template** — Rust module annotated with `#[template]`; defines logic and state. Compiled to WASM and deployed. | ||
| - **Component** — Live instance of a template on-chain. Holds state and exposes public methods. | ||
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. |
There was a problem hiding this comment.
While simplifying the key concepts is good, removing the phrase 'Cannot be copied or accidentally destroyed' for Resource might omit a crucial piece of information. This is a fundamental principle of resource-oriented programming and is important for developers to understand the asset safety guarantees of the platform. I'd suggest re-adding it for clarity.
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. | |
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. Cannot be copied or accidentally destroyed. |
| - **Transaction** — A set of instructions (CallFunction, CallMethod, etc.) that are signed, submitted, and executed atomically. | ||
| - **Template** — Rust module annotated with `#[template]`; defines logic and state. Compiled to WASM and deployed. | ||
| - **Component** — Live instance of a template on-chain. Holds state and exposes public methods. | ||
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. |
There was a problem hiding this comment.
While simplifying the key concepts is good, removing the phrase 'Cannot be copied or accidentally destroyed' for Resource might omit a crucial piece of information. This is a fundamental principle of resource-oriented programming and is important for developers to understand the asset safety guarantees of the platform. I'd suggest re-adding it for clarity.
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. | |
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. Cannot be copied or accidentally destroyed. |
| - **Transaction** — A set of instructions (CallFunction, CallMethod, etc.) that are signed, submitted, and executed atomically. | ||
| - **Template** — Rust module annotated with `#[template]`; defines logic and state. Compiled to WASM and deployed. | ||
| - **Component** — Live instance of a template on-chain. Holds state and exposes public methods. | ||
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. |
There was a problem hiding this comment.
While simplifying the key concepts is good, removing the phrase 'Cannot be copied or accidentally destroyed' for Resource might omit a crucial piece of information. This is a fundamental principle of resource-oriented programming and is important for developers to understand the asset safety guarantees of the platform. I'd suggest re-adding it for clarity.
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. | |
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. Cannot be copied or accidentally destroyed. |
| - **Transaction** — A set of instructions (CallFunction, CallMethod, etc.) that are signed, submitted, and executed atomically. | ||
| - **Template** — Rust module annotated with `#[template]`; defines logic and state. Compiled to WASM and deployed. | ||
| - **Component** — Live instance of a template on-chain. Holds state and exposes public methods. | ||
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. |
There was a problem hiding this comment.
While simplifying the key concepts is good, removing the phrase 'Cannot be copied or accidentally destroyed' for Resource might omit a crucial piece of information. This is a fundamental principle of resource-oriented programming and is important for developers to understand the asset safety guarantees of the platform. I'd suggest re-adding it for clarity.
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. | |
| - **Resource** — Native digital asset (fungible token or NFT). Created with `ResourceBuilder`. Cannot be copied or accidentally destroyed. |
Hey @jie023 👋
I ran your skills through
tessl skill reviewat work and found some targeted improvements. Here's the full before/after:This PR intentionally caps changes at five skills to keep it reviewable. The included GitHub Action workflow (see below) will surface Tessl feedback on future
SKILL.mdchanges across the whole repo.What changed in each skill
All five skills shared the same structural issues:
Skill-specific improvements:
evaluate+fetchpatterns for real browser-level concurrency testing🤖 Automated Skill Review (GitHub Action)
This PR also adds
.github/workflows/skill-review.yml— a lightweight GitHub Action that reviews skills automatically on future PRs.How it works and why it helps
**/SKILL.md, the workflow runstesslio/skill-reviewand posts one PR comment with Tessl scores and feedback (updated on new pushes).GITHUB_TOKENis used to post the comment.with: fail-threshold: 70to the workflow step.SKILL.mdgets automatic review comments, so the rest of the library improves incrementally.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 🙏