Skip to content

feat: add complete skill tree (16 skills + 8 references)#3916

Open
KyleAMathews wants to merge 2 commits intomainfrom
skillz2
Open

feat: add complete skill tree (16 skills + 8 references)#3916
KyleAMathews wants to merge 2 commits intomainfrom
skillz2

Conversation

@KyleAMathews
Copy link
Contributor

Summary

  • Adds 16 task-focused SKILL.md files + 8 reference files under packages/typescript-client/skills/
  • Follows flat task-focused architecture (domain discovery found this outperforms nested domain grouping)
  • Every skill uses spec frontmatter: name, description, type, library, library_version, sources, and requires for composition skills
  • Body structure: Setup → Core Patterns → Common Mistakes (Wrong/Correct + mechanism + source) → Tensions → References
  • All skills under 500 lines, minimum 3 sourced failure modes each
  • 4 cross-domain tensions wired across relevant skill pairs
  • Adds "skills" to package.json files array

Skills created

Sub-skills (7): electric-quickstart, electric-shapes, electric-http-api, electric-proxy, electric-auth, deploying-electric, electric-go-live, electric-proxy-config, electric-testing

Composition (6): electric-tanstack-integration, electric-drizzle, tanstack-start-quickstart, electric-nextjs, electric-expo, y-electric

Security (1): electric-security-check

References (8): shape-options, parser-types, subset-params, electric-cloud, docker, self-hosted

Source material

Existing skills from skillz branch (5 files reformatted), AGENTS.md, domain_map.yaml, troubleshooting.md, and example apps (nextjs, tanstack-db-expo-starter, yjs).

Test plan

  • Verify wc -l on all SKILL.md files — all under 500
  • Grep for library_version — present in every frontmatter
  • Count Common Mistakes per skill — minimum 3 each
  • Verify composition skills have requires
  • Spot-check code blocks for real @electric-sql and @tanstack imports
  • Verify 4 tensions appear in correct skill pairs

🤖 Generated with Claude Code

…ces)

Task-focused flat skill architecture following domain discovery findings.
Each skill has spec-format frontmatter (type, library_version, sources,
requires), structured body (Setup → Core Patterns → Common Mistakes →
References), and cross-domain tension notes.

Skills: quickstart, shapes, http-api, proxy, auth, security-check,
tanstack-integration, drizzle, tanstack-start-quickstart, deploying,
go-live, proxy-config, testing, nextjs, expo, y-electric.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@pkg-pr-new
Copy link

pkg-pr-new bot commented Feb 25, 2026

Open in StackBlitz

npm i https://pkg.pr.new/@electric-sql/react@3916
npm i https://pkg.pr.new/@electric-sql/client@3916
npm i https://pkg.pr.new/@electric-sql/y-electric@3916

commit: a974176

@codecov
Copy link

codecov bot commented Feb 25, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 87.20%. Comparing base (d14f504) to head (a974176).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #3916   +/-   ##
=======================================
  Coverage   87.20%   87.20%           
=======================================
  Files          25       25           
  Lines        2391     2391           
  Branches      597      602    +5     
=======================================
  Hits         2085     2085           
  Misses        304      304           
  Partials        2        2           
Flag Coverage Δ
packages/experimental 87.73% <ø> (ø)
packages/react-hooks 86.48% <ø> (ø)
packages/start 82.83% <ø> (ø)
packages/typescript-client 91.87% <ø> (ø)
packages/y-electric 56.05% <ø> (ø)
typescript 87.20% <ø> (ø)
unit-tests 87.20% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@blacksmith-sh

This comment has been minimized.

- Fix SQL injection hazard: replace string interpolation in WHERE clauses
  with parameterized $1 + params in electric-nextjs and electric-proxy
- Clarify Cloud vs self-hosted auth: separate env var examples in quickstart,
  decouple secret from source_id in proxy code
- Soften forward-looking "Electric 2.0" claim in http-api to cite source docs
- Expand Vary header guidance in electric-auth: Cookie vs Authorization,
  Cache-Control for CDN-fronted authenticated shapes
- Make required proxy headers an explicit list in electric-proxy: electric-offset,
  electric-handle, electric-schema, cache-control, etag

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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