New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Dirextalk Backend Contract State Storage

by YingSuiAI in YingSuiAI/dirextalk-message-server

A skill your agent uses when Dirextalk backend work changes ProductCore or MCP contracts, authentication, realtime WS behavior, Matrix events or state, projection, durable storage, reports…

AGPL-3.0Auto-check passedBackend & APIs

Install Dirextalk Backend Contract State Storage

skills CLI
$ npx skills add YingSuiAI/dirextalk-message-server --skill dirextalk-backend-contract-state-storage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install YingSuiAI/dirextalk-message-server dirextalk-backend-contract-state-storage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/YingSuiAI/dirextalk-message-server.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/dirextalk-backend-contract-state-storage .claude/skills/dirextalk-backend-contract-state-storage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dirextalk-backend-contract-state-storage
GitHub stars
124
Token cost
~1.2k tokens
SKILL.md length
569 words
Files
2
Skills in repo
2
Repo updated
First seen
Licence
AGPL-3.0

At a glance

A skill your agent uses when Dirextalk backend work changes ProductCore or MCP contracts, authentication, realtime WS behavior, Matrix events or state, projection, durable storage, reports…

  • Dirextalk backend work changes ProductCore
  • SKILL.md covers Establish The Contract, Reuse Matrix, Realtime And Push and Persist Correctly
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Realtime WS behavior

What it does

Dirextalk Backend Contract State Storage is an agent skill from YingSuiAI/dirextalk-message-server. Use when Dirextalk backend work changes ProductCore or MCP contracts, authentication, realtime WS behavior, Matrix events or state, projection, durable storage, reports, Agent/system rooms, groups, channels, or cross-node behavior.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Backend & APIs. It works with Model Context Protocol. The licence is AGPL-3.0.

When your agent uses it

  • Dirextalk backend work changes ProductCore
  • Realtime WS behavior
  • Durable storage
  • Agent/system rooms

Example prompts

  • “/dirextalk-backend-contract-state-storage”

What it can do on your machine

Read from SKILL.md and the folder at commit 7bb76d7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dirextalk Backend Contract State Storage loads about 1.2k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 569 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from YingSuiAI/dirextalk-message-server at commit 7bb76d7, republished under its AGPL-3.0 licence (© YingSuiAI). 569 words, ~1,234 tokens.

Download SKILL.mdSave it as .claude/skills/dirextalk-backend-contract-state-storage/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
dirextalk-backend-contract-state-storage
description
Use when Dirextalk backend work changes ProductCore or MCP contracts, authentication, realtime WS behavior, Matrix events or state, projection, durable storage, reports, Agent/system rooms, groups, channels, or cross-node behavior.

Backend Contract, State, And Storage

Establish The Contract

Read the relevant generated/action contract, docs/agent-mcp-current-contract.md, focused tests, and current implementation before editing. Treat hand-written action lists as commentary, not authority.

  • Product requests use the existing {action, params} envelope through HTTP or owner realtime WS. After server.ready, logged-in non-MCP actions may use WS client.request; when WS is not ready, use the same envelope through HTTP immediately. Retry a lost WS response over HTTP only for safe repeated actions, never for a WS business error.
  • GET /_p2p/ws accepts a short-lived single-use owner ticket. Owner bearer tokens protect HTTP ProductCore calls. agent_token is limited to agent.matrix_session.create and POST /mcp.
  • POST /mcp is bearer-authenticated Streamable HTTP JSON-RPC (initialize, tools/list, tools/call), not a ProductCore action. Keep fixed mcp.* body actions removed and never forward the inbound bearer token.
  • release.v1.apply and portal.account.delete remain owner HTTP-only destructive commands. Release compatibility and operations come from the host updater, not local SemVer guesses.
  • When a field, auth rule, route, or transport changes, update the generated contract/focused docs, server tests, and affected consumers together.
  • Flutter connects only to Message Server. The external Agent owns its runtime, data, secrets, and runners; Message Server owns authentication, ProductCore actions/streams, and Product Capability callbacks.
  • Native chat accepts only the complete server profile ID/revision/credential version pins. Reject inline profiles, history, tool credentials, and nested credential-like keys before HTTP, WS, replay, or cancellation dispatch.
  • Product Capability handlers never synchronously call Agent. Preserve owner, account-generation, scope, operation, and call-chain fences in both gRPC directions; loops fail closed.

Reuse Matrix

  • Ordinary message/media/history/search/unread/read-marker/redaction behavior stays on Matrix APIs.
  • Product room type/profile/member policy/join requests use native Matrix state. Matrix membership=join is the final joined fact.
  • New groups use history_visibility=joined; current channels are unified post+chat rooms and use shared. channel_type metadata is not a behavior switch.
  • agent_room_id and system_room_id are real durable Matrix rooms. Agent availability is io.dirextalk.agent.status state keyed by @agent:<server>; owner reports are msg_type=report timeline events.
  • Native Agent tools and external /mcp share internal/dirextalkmcp schemas, authorization, pagination, DTOs, errors, and invocation. Adapt dependencies in p2p; do not fork MCP business logic.
  • Native Agent navigation references are derived only from successful built-in Dirextalk tool-result envelopes, not model text or third-party/runtime tools. Keep room/post identity fields additive, deterministic, ordered, deduplicated, and free of message event_id unless the product contract explicitly expands to message-level navigation.
  • Remote public lookup uses the supplied remote_node_base_url. Approval is not joined until the requester node completes Matrix join.
Show full SKILL.md (169 more words)Show less

Realtime And Push

  • Product deltas are WS server.event messages with persisted sequence handling and client.ack; reset uses server.cursor_reset followed by a fresh metadata bootstrap.
  • WS client.lifecycle and client.focus are the primary foreground/current-room signals for notification suppression. Global account data io.dirextalk.push.context is only a secondary fallback.
  • Keep bootstrap metadata-only; message bodies and timeline history remain Matrix responsibilities.

Persist Correctly

  • Persist restart-relevant product facts in PostgreSQL. Update interfaces, migrations, implementations, callers, and tests together; keep migrations additive/idempotent where practical.
  • Product projections follow Matrix output. Do not mutate a projection as an independent source of truth unless the domain contract explicitly says so.
  • Account deletion first persists updater desired state deprovisioned; abort destructive work if that fails. Later failure best-effort restores running and returns a stable safe error if restoration also fails.
  • Add restart/reopen coverage when recovery changes, and multi-node coverage when federation, remote join, or projection convergence changes.
  • Agent integration uses a fresh schema owned by the Agent role. Do not add an embedded store, compatibility import, or cross-role table access.

© YingSuiAI, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .codex/skills/dirextalk-backend-contract-state-storage of YingSuiAI/dirextalk-message-server.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 7bb76d7

Compare with similar skills

Dirextalk Backend Contract State Storage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dirextalk Backend Contract State Storage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dirextalk Backend Contract State Storage this skillYingSuiAI/dirextalk-message-server124—~1.2kAutomated safety check: PassAGPL-3.0
Supabase Development and Debuggingsupabase/agent-skills2.7k3 repos~3.6kAutomated safety check: PassMIT
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0
Supabasecurvenote/curvenote1705 repos~2.2kAutomated safety check: PassCustom licence
AWS Serverless Edazxkane/aws-skills3674 repos~3.2kAutomated safety check: PassMIT
FoundatioFoundatioFx/Foundatio2.1k—~3.9kAutomated safety check: PassApache-2.0

Similar skills

  • Supabase Development and Debugging

    supabase/agent-skills

    Official

    General Supabase skill for database, auth, Edge Functions, Realtime and storage work, plus client libraries, migrations, security audits, debugging and reading logs.

    2.7k GitHub starsUsed in 3 repos~3.6k tokens
    Backend & APIsAuto-check passed

  • OpenAPI to MCP Server

    mcp-use/mcp-use

    Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.

    11k GitHub stars~5.2k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

  • Supabase

    curvenote/curvenote

    A skill your agent uses when doing ANY task involving Supabase.

    170 GitHub starsUsed in 5 repos~2.2k tokens
    Backend & APIsAuto-check passed

  • AWS Serverless Eda

    zxkane/aws-skills

    AWS serverless and event-driven architecture expert based on Well-Architected Framework.

    367 GitHub starsUsed in 4 repos~3.2k tokens
    Backend & APIsAuto-check passed

  • Foundatio

    FoundatioFx/Foundatio

    A skill your agent uses when working with Foundatio infrastructure abstractions for .NET -- caching, queuing, messaging, file storage, distributed locking, or background jobs.

    2.1k GitHub stars~3.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

  • Legba

    evilsocket/legba

    A skill your agent uses when the user wants to brute-force credentials, spray passwords, or enumerate services/subdomains against any network protocol (HTTP, SSH, FTP, SMB, RDP, databases, mail…

    1.9k GitHub stars~2.2k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed

More from YingSuiAI/dirextalk-message-server

  • Dirextalk Message Server Release

    YingSuiAI/dirextalk-message-server

    A skill your agent uses when preparing, verifying, publishing, retrying, or auditing a stable Dirextalk message-server version image and GitHub Release.

    124 GitHub stars~533 tokensUpdated 14 days ago
    Auto-check passed

Works with

Categories

Questions about Dirextalk Backend Contract State Storage

What does Dirextalk Backend Contract State Storage do?

A skill your agent uses when Dirextalk backend work changes ProductCore or MCP contracts, authentication, realtime WS behavior, Matrix events or state, projection, durable storage, reports…. Dirextalk Backend Contract State Storage is an agent skill from YingSuiAI/dirextalk-message-server. Use when Dirextalk backend work changes ProductCore or MCP contracts, authentication, realtime WS behavior, Matrix events or state, projection, durable storage, reports, Agent/system rooms, groups, channels, or cross-node behavior.

When should I use Dirextalk Backend Contract State Storage?

Dirextalk Backend Contract State Storage fits situations like: dirextalk backend work changes ProductCore; realtime WS behavior; durable storage; agent/system rooms.

How do I install Dirextalk Backend Contract State Storage in Claude Code?

Run `npx skills add YingSuiAI/dirextalk-message-server --skill dirextalk-backend-contract-state-storage -a claude-code`. Or copy the skill folder (.codex/skills/dirextalk-backend-contract-state-storage in YingSuiAI/dirextalk-message-server) into .claude/skills/dirextalk-backend-contract-state-storage in your project. Claude Code loads it when a task matches its description.

How do I install Dirextalk Backend Contract State Storage in Codex?

Run `npx skills add YingSuiAI/dirextalk-message-server --skill dirextalk-backend-contract-state-storage -a codex`. Or copy the skill folder (.codex/skills/dirextalk-backend-contract-state-storage in YingSuiAI/dirextalk-message-server) into .agents/skills/dirextalk-backend-contract-state-storage in your project. Codex loads it when a task matches its description.

Can I use Dirextalk Backend Contract State Storage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add YingSuiAI/dirextalk-message-server --skill dirextalk-backend-contract-state-storage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dirextalk-backend-contract-state-storage, .gemini/skills/dirextalk-backend-contract-state-storage, .github/skills/dirextalk-backend-contract-state-storage and .opencode/skills/dirextalk-backend-contract-state-storage in your project.

What does Dirextalk Backend Contract State Storage need to run?

SKILL.md names no scripts, command-line tools or credentials: Dirextalk Backend Contract State Storage is instructions for the agent only.

Does Dirextalk Backend Contract State Storage access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dirextalk Backend Contract State Storage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dirextalk Backend Contract State Storage use?

Dirextalk Backend Contract State Storage is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dirextalk Backend Contract State Storage use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dirextalk Backend Contract State Storage?

Skills that share tags, products or a category with Dirextalk Backend Contract State Storage: Supabase Development and Debugging (supabase/agent-skills, 2.7k stars), OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars), Supabase (curvenote/curvenote, 170 stars) and AWS Serverless Eda (zxkane/aws-skills, 367 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dirextalk Backend Contract State Storage?

YingSuiAI (a GitHub organization) maintains it in YingSuiAI/dirextalk-message-server, which has 124 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on September 27, 2026.

Source: YingSuiAI/dirextalk-message-server on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.