contract-first SKILL.md skillA

contract-first from wankimmy/bossku-superpowers is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add wankimmy/bossku-superpowers/contract-first@git:20261012.feb2361

Pins git:20261012.feb2361 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
wankimmy/bossku-superpowers
Path
skills/bosskuai-contract-first/references/upstream/SKILL.md
Versions recorded
1
Latest version
git:20261012.feb2361, committed Oct 12, 2026
Size
9,761 bytes
Repository stars
22
License
MIT

Coordinate frontend/backend or service-to-service work through one authoritative machine-checkable contract (OpenAPI, AsyncAPI, Protocol Buffers, or JSON Schema), with generated consumer types and contract-verified integration. Use when parallel consumer and provider work must evolve an API or event schema without field drift, mock/production shape mismatch, or one side silently redefining the interface.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Contract-First Collaboration

Coordinate frontend/backend or service-to-service work through one authoritative,
machine-checkable contract. Consumers state what they need, providers implement
that shape, and both sides verify against the same artifact before integration.

This skill governs how teams change a boundary. It complements `api-design`,
which governs what a good API looks like, and `ai-regression-testing`, which
guards fixed bugs from returning.

## When to Activate

- Frontend and backend work will proceed in parallel.
- Two or more services exchange API payloads, events, or commands.
- Field names, nullability, enums, or error shapes regularly drift.
- One consumer needs several calls because the provider exposed storage models
  instead of a task-oriented response.
- A provider change can break consumers maintained by another person or agent.
- Mock responses and production responses no longer have the same shape.

Do not add contract machinery to a single-module boundary that changes in one
atomic commit and has no independent consumer. A shared type may be enough.

## The Boundary Artifact

Choose one canonical, version-controlled artifact for each boundary:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add wankimmy/bossku-superpowers/contract-first@sha256:3eaacf16a9bbd928

The line at the top of this page pins the label git:20261012.feb2361, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_2clenunpmbakcoko.svg)](https://markdownregistry.com/a/art_2clenunpmbakcoko)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 12, 2026.

versioncommittedcommitsizeaudit
git:20261012.feb2361 latest2026-10-12 feb2361 9,761 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9761 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

wankimmy/bossku-superpowers · 22 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2clenunpmbakcoko
GET https://markdownregistry.com/api/v1/resolve?ref=wankimmy/bossku-superpowers/contract-first
GET https://markdownregistry.com/api/v1/blob/3eaacf16a9bbd92888659e9c1e15b0fa4eb96a41c257dd9e08f2e63b824f0cea

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from wankimmy/bossku-superpowers

bosskuai Cursor rule
wankimmy/bossku-superpowers · .cursor/rules/bosskuai.mdc · BosskuAI co-founder contract — indicator, routing, ponytail, anti-slop, loop engineering, grounding.
git:20261009.037c4b1 · audit A · 22 stars
AGENTS.md@.omp AGENTS.md file
wankimmy/bossku-superpowers · .omp/AGENTS.md
git:20260802.2f685b9 · audit B · 22 stars
AGENTS.md AGENTS.md file
wankimmy/bossku-superpowers · AGENTS.md
git:20261009.037c4b1 · audit A · 22 stars
CLAUDE.md CLAUDE.md file
wankimmy/bossku-superpowers · CLAUDE.md
git:20260716.6355db6 · audit B · 22 stars
ab-testing SKILL.md skill
wankimmy/bossku-superpowers · skills/ab-testing/SKILL.md · When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program…
v2.0.0 · audit A · 22 stars
accessibility SKILL.md skill
wankimmy/bossku-superpowers · skills/accessibility/SKILL.md · Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that…
git:20260907.6a40a93 · audit A · 22 stars
ad-creative SKILL.md skill
wankimmy/bossku-superpowers · skills/ad-creative/SKILL.md · When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad…
v2.8.0 · audit A · 22 stars
ads SKILL.md skill
wankimmy/bossku-superpowers · skills/ads/SKILL.md · When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X…
v2.2.0 · audit A · 22 stars
ai-seo SKILL.md skill
wankimmy/bossku-superpowers · skills/ai-seo/SKILL.md · When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers…
v2.2.0 · audit A · 22 stars
analytics SKILL.md skill
wankimmy/bossku-superpowers · skills/analytics/SKILL.md · When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions…
v2.0.0 · audit A · 22 stars
animate-expo SKILL.md skill
wankimmy/bossku-superpowers · skills/animate-expo/SKILL.md · Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right —…
git:20260907.6a40a93 · audit A · 22 stars
animate SKILL.md skill
wankimmy/bossku-superpowers · skills/animate/SKILL.md · Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it…
git:20260907.6a40a93 · audit A · 22 stars

Every file in wankimmy/bossku-superpowers

Other files named contract-first

contract-first SKILL.md skill
qshanx/docs-governance · skills/engineering/contract-first/SKILL.md · 也适用于同一进程内存在明确消费者、提供者和公共接口且有漂移风险的业务模块;按实际边界验证公开签名与行为,无网络边界时不要求序列化证据。 分前端/后端(或多个服务)多端开发的项目,用 CONTRACT.md…
git:20261012.bd30f6e · audit A · 218 stars

Browse by kind, by grade A, or by owner.