← Skills
WHAT IT TEACHES YOUR AI
Design the entity schema before code: types, attributes vs payload, relationships, namespaces — from 124 real builds.
entity-type designattributes vs payloadrelationship modelingproject namespacingstatus state machinesnumeric attribute discipline
14patterns mined
3gotchas prevented
13evidence projects
2026-06-11last verified
PATTERNS MINED FROM REAL BUILDS
entityType-discriminator (table = type attribute)44 builds
project-namespace attribute on EVERY write AND query41 builds
creator-filter as injection defense (namespaces are organization, NOT auth)2 builds
foreign-keys via shared attribute values38 builds
attributes-for-filtering, payload-for-content30 builds
numeric-attributes discipline (schema half)24 builds
media/blob storage decision tree10 builds
status-attribute state machine9 builds
version history: immutable revisions + mutable pointer7 builds
interaction-entity-owned-by-the-actor6 builds
graph topology as entities5 builds
Arkiv as the boring app database4 builds
denormalize-for-single-query2 builds
multi-value tags (enumerated slots or junction entities)2 builds
Verified against
- SDK @arkiv-network/sdk >=0.6.5 <0.7.0 (verified 0.6.8)
- Network braga · chainId 60138453102
- Last verified 2026-06-11
- authored against SDK 0.6.8 source survey + 124-submission evidence corpus
DISTILLED FROM REAL HACKATHON PROJECTS
HostrArk-AgentFhedinSealVaultSusurroVEILMeshOWNMentorGraphArklibNEXUSOpenCluRecallKitRoxium
SDK SURFACE IT USES
The exact @arkiv-network/sdk symbols this skill teaches — the update radar watches these against new SDK releases and open PRs.
createPublicClientcreateWalletClienthttpprivateKeyToAccountbragacreateEntityupdateEntitymutateEntitiesgetEntitybuildQuerywherecreatedBywithAttributeswithPayloadlimitfetcheqjsonToPayloadExpirationTimeAttributeNoEntityFoundErrortoJson
USE IT
Hand it to your AI before it writes Arkiv code
Copy the install prompt into Claude Code / Cursor / Codex, or fetch the raw markdown yourself. Plain text, no auth.