Skip to content

Improve/skill review optimization#5

Open
yogesh-tessl wants to merge 2 commits intodgrr:mainfrom
yogesh-tessl:improve/skill-review-optimization
Open

Improve/skill review optimization#5
yogesh-tessl wants to merge 2 commits intodgrr:mainfrom
yogesh-tessl:improve/skill-review-optimization

Conversation

@yogesh-tessl
Copy link
Copy Markdown

Hey @dgrr 👋

Pure Rust with no TDLib dependency is a bold architectural call, and the feature surface is surprisingly complete: FTS5 local search, incremental sync with checkpoints, sticker support, even chat folders. The fact you're shipping Homebrew taps and install scripts at v0.3.7 shows this is being built for real users, not just a toy. Wanted to suggest a few improvements to the SKILL.md.

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

score_card
Changes made

Workflow clarity improvements:

  • Added explicit 5-step setup workflow with verification checkpoints (auth → verify session → sync → verify data)
  • Introduced verify-then-act pattern for destructive operations - messages show before messages delete, chats list before wipe
  • Added safety warnings for irreversible actions (leaving private groups, database wipe, admin moderation)
  • Grouped destructive operations (wipe, ban, kick, delete) into a dedicated section with guidance

Progressive disclosure improvements:

  • Moved less-common command groups (stickers, folders, admin, daemon, utilities) to a new REFERENCE.md
  • Added clear cross-reference link from SKILL.md to REFERENCE.md
  • Consolidated contacts and users into a single compact section
  • Compressed tips & tricks into a single code block - same content, fewer lines

Minor cleanup:

  • Standardised frontmatter description to quoted string format
  • Removed Quick Start section (replaced by more structured Setup workflow)

Honest disclosure. I work at https://github.com/tesslio where we build tooling around skills like these. Not a pitch - just saw room for improvement and wanted to contribute.

I also added a lightweight GitHub Action that auto-reviews any skill.md changed in a PR (includes min permissions, uses a pinned action version, only posts a review comment).

This means that it gives you and your contributors an instant quality signal before you have to review yourself (no signup, no tokens needed).

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 🙏

Hey @dgrr 👋

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 |
|-------|--------|-------|--------|
| tgcli | 92% | 100% | +8% |

<details>
<summary>Changes made</summary>

**Workflow clarity improvements:**
- Added explicit 5-step setup workflow with verification checkpoints (auth → verify session → sync → verify data)
- Introduced verify-then-act pattern for destructive operations — `messages show` before `messages delete`, `chats list` before `wipe`
- Added safety warnings for irreversible actions (leaving private groups, database wipe, admin moderation)
- Grouped destructive operations (`wipe`, `ban`, `kick`, `delete`) into a dedicated section with guidance

**Progressive disclosure improvements:**
- Moved less-common command groups (stickers, folders, admin, daemon, utilities) to a new `REFERENCE.md`
- Added clear cross-reference link from `SKILL.md` to `REFERENCE.md`
- Consolidated contacts and users into a single compact section
- Compressed tips & tricks into a single code block — same content, fewer lines

**Minor cleanup:**
- Standardized frontmatter description to quoted string format
- Removed Quick Start section (replaced by more structured Setup workflow)

</details>

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 🙏
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