Add AgentSkills.io integration for AI coding assistants #4172
Conversation
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
Create 5 skill files that enable developers to install SpacetimeDB expertise into Claude Code, Cursor, Cline, and 40+ other AI agents via `npx skills add spacetimedb/spacetimedb`. Skills included: - spacetimedb-rust: Server module development (tables, reducers, macros) - spacetimedb-typescript: TypeScript SDK (connection, subscriptions, React) - spacetimedb-csharp: C#/Unity SDK (BSATN, Unity integration, threading) - spacetimedb-cli: CLI workflows (init, build, publish, generate) - spacetimedb-concepts: Core architecture (tables, reducers, subscriptions)
douglance
force-pushed
the
feature/agentskills-integration
branch
from
f6c98ed to
846f6c6
Compare
Incorporate critical information from reference files: - Add "HALLUCINATED APIs" sections with wrong patterns to avoid - Add "Common Mistakes Tables" for server/client errors - Add hard requirements for each language - Add procedures (beta) sections for Rust/TypeScript - Add sum types/TaggedEnum section for C# - Add views and ctx.withTx() patterns for TypeScript - Add RLS patterns for Rust - Add feature implementation and debugging checklists for concepts
The symlink wasn't being followed when cloned from GitHub. Both skills/ and .claude/skills/ now contain the actual files.
Skills should only be in skills/ directory for agentskills.io distribution. Users install to their own .claude/skills/ via npx skills add.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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.
Summary
Add AgentSkills.io integration so developers can give their AI coding assistants SpacetimeDB expertise.
What is AgentSkills.io?
AgentSkills.io is an open standard for distributing domain knowledge to AI coding assistants. After this PR is merged, developers can run:
The skills are installed into whichever AI coding tools they use - Claude Code, Cursor, Cline, GitHub Copilot, Windsurf, and 40+ others. The AI then has access to SpacetimeDB-specific patterns, common mistakes to avoid, and correct API usage.
Test Now
You can test this PR before it's merged:
Why This Matters
LLMs frequently hallucinate SpacetimeDB APIs that don't exist:
#[spacetimedb::table]instead of#[table]ctx.db.playerinstead ofctx.db.player()conn.reducers.foo("value")instead ofconn.reducers.foo({ param: "value" })These skills teach AI assistants the correct patterns and warn about common mistakes, reducing debugging time for developers using AI tools.
Skills Included
spacetimedb-rustspacetimedb-typescriptspacetimedb-csharpspacetimedb-clispacetimedb-conceptsEach skill includes:
Directory Structure
Usage (after merge)
Test Plan
npx skills add . --listshows 5 skillsnpx skills add . -s spacetimedb-rust --yesinstalls to 28+ agents