Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

System Contract Map · velcrafting | DecimalAI

documentationby velcrafting

System Contract Map

velcrafting/system-contract-map

Source velcrafting/codex-skills ↗License Not recorded

You are executing the SKILL: system-contract-map.

NewMaintained

Automatic

Coding pack

Last verified 8/3/2026

What it changes

4 of 22 test cases passed with the skill.

Pass-rate lift: —
Tokens: +106%
Agent turns: 0%
Response time: +86%

Model gemini-3.6-flashMeasured 8/3/2026v14 of 22 cases passed with skill · 6 comparable

Tokens, turns and time describe resource use, not a dollar price.

Lift withheld: 6 comparable cases; this report requires 8.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/velcrafting-system-contract-map/SKILL.md https://app.decimal.ai/s/velcrafting-system-contract-map/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add velcrafting-system-contract-map, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/velcrafting-system-contract-map/ and pins it in .decimal/skills.lock

decimalai skills add velcrafting-system-contract-map

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/velcrafting-system-contract-map/SKILL.md https://app.decimal.ai/s/velcrafting-system-contract-map/SKILL.md

Raw file: /s/velcrafting-system-contract-map/SKILL.md ↗ · machine-readable summary at /s/velcrafting-system-contract-map.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 2 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 2

Prompt

We need to document system invariants and boundary assumptions in markdown. What exact file location should be written or appended to?

What was checked, without and with the skill
Checked	Without skill	With skill
Uses the file path docs/diagrams/system/invariants.md	Missed	Passed

case-08 · gemini-3.6-flash · 8/3/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md35 linessingle file

You are executing the SKILL: system-contract-map.

Context: This repository contains a multi-layer system with:

Frontend
API
Backend
Multiple market domains (crypto, stocks, prediction markets)
Distinct AI/strategy logic and execution logic

Task: Produce a system-level contract map that defines structure and expectations, not implementation detail.

Requirements:

Identify core containers and boundaries
Identify cross-boundary interactions
Explicitly separate intent/decision logic from execution logic
Document invariants that must always hold
Do not model fine-grained state or UI logic

Outputs (write files exactly to these paths):

docs/diagrams/system/c4/container.mmd
docs/diagrams/system/sequences/-order.mmd for:
- crypto
- stock
- prediction
docs/diagrams/system/invariants.md (append if exists)

Rules:

Use Mermaid syntax
Optimize for clarity and correctness, not completeness
If assumptions are required, list them explicitly in invariants
Do not invent features that are not implied by the repo

Begin by analyzing the repository structure and existing docs before producing artifacts.

Track record

Benchmark

4 / 22

test cases passed with the skill

Adoption

Users: 2
Times used: 39

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/1/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

velcrafting / codex-skills

skills/system/system-contract-map/SKILL.md

View on GitHub ↗

Imported 8/1/2026Version v1

More skills from the same source and nearby in the registry, with their headline benchmark lift.