sdk-dx SKILL.md skillA

sdk-dx from jonathimer/devmarketing-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jonathimer/devmarketing-skills/sdk-dx@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jonathimer/devmarketing-skills
Path
skills/sdk-dx/SKILL.md
Versions recorded
1
Latest version
v1.0.0, committed Mar 3, 2026
Size
13,371 bytes
Repository stars
87
License
MIT

Design SDKs that developers love to use—APIs that feel native, error messages that guide, and experiences that reduce friction. This skill covers creating SDKs that drive adoption through exceptional developer experience rather than aggressive marketing. Trigger phrases: "SDK design", "developer experience", "API design", "SDK DX", "error messages", "type safety", "IDE integration", "SDK versioning", "migration guides", "client library design", "making SDKs feel native", "SDK best practices".

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

# SDK Design and Developer Experience

The best SDK marketing is an SDK that developers can't stop talking about. When your SDK makes developers feel productive and competent, they become your advocates. When it frustrates them, no amount of marketing will save you.

## Overview

SDK developer experience (DX) encompasses everything a developer feels when using your library:
- **Discovery**: How easily can they find and install it?
- **Learning**: How quickly can they understand how to use it?
- **Using**: How productive are they day-to-day?
- **Debugging**: How easily can they fix problems?
- **Upgrading**: How painlessly can they adopt new versions?

Great SDK DX is a competitive advantage. Developers choose tools that make them feel smart.

## Before You Start

Review the **developer-audience-context** skill to understand:
- What languages and frameworks do your target developers use?
- What IDE/editor setups are most common?
- What's their experience level with your problem domain?
- What competing SDKs have they used? What do they like/dislike?

SDK design decisions should flow from deep understanding of your users.

## API Design Principles
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jonathimer/devmarketing-skills/sdk-dx@sha256:67a4eea49cb42eed

The line at the top of this page pins the label v1.0.0, 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_v2jvcebsnnt5yqal.svg)](https://markdownregistry.com/a/art_v2jvcebsnnt5yqal)

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

Versions

The registry has recorded 1 version of this file, committed on Mar 3, 2026.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-03-03 500b44b 13,371 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 (13371 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

jonathimer/devmarketing-skills · 87 stars · license MIT · pushed 2026-03-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_v2jvcebsnnt5yqal
GET https://markdownregistry.com/api/v1/resolve?ref=jonathimer/devmarketing-skills/sdk-dx
GET https://markdownregistry.com/api/v1/blob/67a4eea49cb42eed47d0874e890d1fda0480f1c5ae739e25857b5243281b6502

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 jonathimer/devmarketing-skills

AGENTS.md AGENTS.md file
jonathimer/devmarketing-skills · AGENTS.md
git:20260303.500b44b · audit A · 87 stars
alternatives-pages SKILL.md skill
jonathimer/devmarketing-skills · skills/alternatives-pages/SKILL.md · Create "[Competitor] alternative" and comparison pages for developer tools. Build honest, high-converting comparison…
v1.0.0 · audit A · 87 stars
api-onboarding SKILL.md skill
jonathimer/devmarketing-skills · skills/api-onboarding/SKILL.md · Reduce time-to-first-API-call (TTFAC) by optimizing every step of the developer onboarding journey. This skill covers…
v1.0.0 · audit A · 87 stars
changelog-updates SKILL.md skill
jonathimer/devmarketing-skills · skills/changelog-updates/SKILL.md · Create release notes and product updates that developers actually read and care about. This skill covers changelog…
v1.0.0 · audit A · 87 stars
community-building SKILL.md skill
jonathimer/devmarketing-skills · skills/community-building/SKILL.md · When the user wants to build, grow, or improve a developer community on Discord, Slack, or forums. Trigger phrases…
v1.0.0 · audit A · 87 stars
competitor-tracking SKILL.md skill
jonathimer/devmarketing-skills · skills/competitor-tracking/SKILL.md · Systematic competitor analysis for developer tools. Track features, pricing, positioning, content strategy, and…
v1.0.0 · audit A · 87 stars
dev-to-hashnode SKILL.md skill
jonathimer/devmarketing-skills · skills/dev-to-hashnode/SKILL.md · When the user wants to publish on Dev.to, Hashnode, or other developer blogging platforms. Trigger phrases include…
v1.0.0 · audit A · 87 stars
dev-tool-directory-listings SKILL.md skill
jonathimer/devmarketing-skills · skills/dev-tool-directory-listings/SKILL.md · Getting listed on developer tool directories, awesome lists, and curated resources. Covers which directories matter for…
v1.0.0 · audit A · 87 stars
developer-ads SKILL.md skill
jonathimer/devmarketing-skills · skills/developer-ads/SKILL.md · Paid advertising strategies for developer audiences on Carbon Ads, BuySellAds, Reddit, and developer newsletters…
v1.0.0 · audit A · 87 stars
developer-advocacy SKILL.md skill
jonathimer/devmarketing-skills · skills/developer-advocacy/SKILL.md · When the user wants to do developer advocacy activities including conference talks, live coding, podcasts, and building…
v1.0.0 · audit A · 87 stars
developer-audience-context SKILL.md skill
jonathimer/devmarketing-skills · skills/developer-audience-context/SKILL.md · When the user wants to establish or update their developer audience context. Also use when starting any other developer…
v1.0.0 · audit A · 87 stars
developer-churn SKILL.md skill
jonathimer/devmarketing-skills · skills/developer-churn/SKILL.md · When the user wants to understand, reduce, or recover from developer churn. Trigger phrases include "why developers…
v1.0.0 · audit A · 87 stars

Every file in jonathimer/devmarketing-skills

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