From 3feab8d2e16d1bea0134a7a90d164454ebe05ca9 Mon Sep 17 00:00:00 2001
From: rohan-tessl <rohan-tessl@users.noreply.github.com>
Date: Mon, 13 Apr 2026 11:53:31 +0530
Subject: [PATCH] feat: improve tgcli skill score from 92% to 97%
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Hey @kfastov 👋

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% | 97% | +5% |

Changes:
- Added First-Time Setup workflow with numbered sequence
  (auth → verify → service install → sync)
- Added error recovery guidance pointing to `tgcli doctor`
- Removed redundant Authentication section
  (duplicated by First-Time Setup)
- Improved Notes section with `--help` hint and
  `tgcli doctor` reference

Content score improved from 80% to 92%, with
workflow_clarity hitting 3/3.
---
 SKILL.md | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/SKILL.md b/SKILL.md
index c4fac5f..3c338f7 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -28,14 +28,25 @@ Or:
 brew install kfastov/tap/tgcli
 ```
 
-## Authentication
-
-First-time setup needs Telegram API credentials from https://my.telegram.org/apps
+## First-Time Setup
 
 ```bash
+# 1. Authenticate (needs API credentials from https://my.telegram.org/apps)
 tgcli auth
+
+# 2. Verify authentication succeeded
+tgcli channels list --limit 1
+
+# 3. Install and start background sync service
+tgcli service install
+tgcli service start
+
+# 4. Begin syncing messages
+tgcli sync --follow
 ```
 
+If auth fails or sync doesn't start, run `tgcli doctor` to diagnose. Verify API credentials are correct at https://my.telegram.org/apps.
+
 ## Common Commands
 
 ### Reading
@@ -84,3 +95,5 @@ tgcli channels list --limit 10 --json
 
 - Use `--source live|archive|both` when listing or searching messages.
 - `--json` is best for AI/tooling pipelines.
+- Run `tgcli [command] --help` for full option details on any command.
+- See `tgcli doctor` for diagnostics if something isn't working.