From 78fccedea5e12e8ab1ef8fe870248f5b16ee32ca Mon Sep 17 00:00:00 2001 From: rohan-tessl Date: Mon, 8 Jun 2026 16:26:14 +0530 Subject: [PATCH] feat: improve stream-cli skill score (91% to 97%) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hey @vaneenige 👋 really like how transparent the README is about what gets installed. That audit table listing every network-touching step with source links is the kind of thing most skill packs don't bother with. 8 skills covering the full Stream stack from CLI operations to platform-specific scaffolding for Swift, Android, RN, and Flutter, that's solid coverage. 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 | |-------|--------|-------|--------| | stream-cli | 91% | 97% | +6% | | stream | 92% | 92% | 0% | | stream-docs | 16% | 16% | 0% | | stream-builder | 85% | 85% | 0% | | stream-swift | 92% | 92% | 0% | | stream-android | 17% | 17% | 0% | | stream-react-native | 92% | 92% | 0% | | stream-flutter | 92% | 92% | 0% | `stream-cli` had the most headroom among your passing skills so I focused there.
Changes made **stream-cli (+6%)**: - Removed the redundant "CLI Rules (summary)" section at the end of SKILL.md, which restated all six points already covered in the CLI Workflow section above it (endpoint discovery, help flags, lazy auth, missing params, safe mode, summarization) - This eliminated token waste without losing any information, since every rule in the summary was already present in the workflow steps and exit code recovery table - Content conciseness score improved from 2/3 to 3/3, bringing the overall score from 91% to 97% - Net change: 9 lines removed, 0 lines added
I also stress-tested your `stream-cli` skill against a few real-world task evals and it held up really well on safe mode refusal recovery for mutating endpoints (the exit code 5 flow with user notification before retry). Solid design. quick 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. If you want to self-improve your skills, or define your own scenarios to pressure test, just ask your agent (Claude Code, Codex, etc.) to evaluate and optimize your skill with Tessl. Ping me @rohan-tessl, if you hit any snags. Thanks in advance 🙏 --- skills/stream-cli/SKILL.md | 9 --------- 1 file changed, 9 deletions(-) diff --git a/skills/stream-cli/SKILL.md b/skills/stream-cli/SKILL.md index 1382672..13abdb9 100644 --- a/skills/stream-cli/SKILL.md +++ b/skills/stream-cli/SKILL.md @@ -92,12 +92,3 @@ Set defaults: `stream config set org ` and `stream config set app `. ### Auth (assistants) - Use **`stream auth login`** with no extra flags, in a terminal where a **browser window can open**. The CLI uses PKCE with the dashboard - that is the supported sign-in path. - -## CLI Rules (summary) - -1. **Endpoint discovery:** **`~/.stream/cache/API.md`** first - never `--list` for discovery. Refresh if missing. -2. **Help:** **`stream --safe api --help`** for parameters after you know the endpoint name. -3. **Lazy auth** - if exit code **2**, **`stream auth login`** then retry. -4. **Missing params** - ask; never invent IDs. -5. **First attempt always `--safe`** - exit **5** -> explain mutating op -> retry without **`--safe`**. -6. **Summarize** API responses concisely for the user.