skill trimming: rewrite core skills and stream-react - #71
Open
myandrienko wants to merge 3 commits into
Open
Conversation
…d stream-docs Fresh-write of the core skills against a hard deletion criterion: a line survives only if it prevents a failure an agent actually hits. Everything the getstream CLI explains itself (-h, getstream docs local copies), the official docs cover, or a competent agent infers was removed. - stream: router + CLI overview, one first-match routing list. RULES.md, peers.yaml, and the track dispatch table are gone. - stream-react: one linear build flow plus sections for auditing, upgrading, design matching, AI support agents, and Sendbird migration. Blueprints and docs-map are replaced by the CLI-served local docs; the curated Sendbird mapping is kept nearly whole, the extended mapping verbatim (grep-only lookup). - stream-builder: deleted - it was a near-clone ancestor of stream-react; its unique content (use-case recipes, page flow) was salvaged. - stream-docs: deleted - docs questions route to getstream docs. Verified by five independent empty-context audits comparing every v1 idea against v2 + CLI help + local docs; the real losses found were restored or explicitly ruled out. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
myandrienko
force-pushed
the
v2-core-skills
branch
from
August 27, 2026 16:04
219f929 to
ddf0736
Compare
Replaces the two rewritten skills with the current v2 text. Changes since the
first rewrite: design refinement scoped to explicit references ("a Slack-like
team chat" is guidance on structure, not a look to match; only a reference
design earns design-matching.md); CLI install marked "unless already present"
with getstream.io/cli as the alternative; Sendbird mapping and kill list kept
complete; wording passes throughout.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
myandrienko
force-pushed
the
v2-core-skills
branch
from
August 28, 2026 17:00
ddf0736 to
f62ef7d
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Replaces the four core skills with the v2 fresh-write:
streamandstream-reactare rewritten from zero;stream-builderandstream-docsare deleted. Net: 919 insertions, 9,624 deletions.The rewrite applies one deletion criterion to every line: it survives only if it prevents a failure an agent actually hits. Everything the
getstreamCLI explains itself (-h,getstream docslocal copies), everything the official docs cover, and everything a competent agent infers on its own was removed.Changes
stream- a ~400-word router: conceptual overview, the CLI as the base tool ("read-h" replaces the command table and safety rules), one first-match routing list.RULES.md,peers.yaml+ schema, the track dispatch table, the verbatim/streammenu, and the trust/consent prose are gone.stream-react- one linear build flow (init, scaffold, credentials, SDKs, configure, build, verify, run) with conditional clauses instead of tracks, plus separate sections for auditing, upgrading an SDK major, matching a reference design, building an AI support agent, and migrating from Sendbird. Product blueprints anddocs-map.mdare replaced by the CLI-served local docs; the curated Sendbird mapping is kept nearly whole (concrete API joins are the knowledge), the extended mapping verbatim as a grep-only lookup.stream-builder- deleted. It was a near-clone ancestor of stream-react (same Steps 0-7, also scaffolds Next.js). Unique content was salvaged: the use-case table, hub-first page flow, and the AI-support-agent recipe (nowstream-react/ai-support-agent.md).stream-docs- deleted. Docs questions route to the local docs viagetstream docs.Verification
Five independent empty-context agents audited v1 against v2, testing every absent idea for recoverability by actually running
getstream -hand reading the local docs pages. Result: ~85-90% of distinct v1 ideas present or verified recoverable; the ~16 real losses were each restored (enhance-mode rules, capability-debugging traps, fixture-channel recipe, the AI recipe, livestream/design gotchas) or explicitly ruled out.Deliberately out of scope (follow-ups)
README.md/AGENTS.mdstill describe the deleted skills and old structure.stream-react-native,stream-feeds-migration(and other packs pending their own rewrites) still reference the deleted../stream/RULES.md/stream-docs.getstream skillsdefault set and the getstream.io agent-skills docs pages still liststream-builder/stream-docs.livestreamcall type really denies host publish grants (v1 claim, currently not restored).import.mdshows the oldstream-cli; video best-practices recommends the deprecated no-opusePersistedDevicePreferences.🤖 Generated with Claude Code