smd-release SKILL.md skillA

smd-release from bislink360/styled-markdown is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bislink360/styled-markdown/smd-release@git:20261031.87b660a

Pins git:20261031.87b660a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
bislink360/styled-markdown
Path
.claude/skills/smd-release/SKILL.md
Versions recorded
10
Latest version
git:20261031.87b660a, committed Oct 31, 2026
First version recorded
Sep 28, 2026
Size
17,387 bytes
Repository stars
3
License
MIT

Branch, version, verify and publish Styled Markdown releases (VS Code extension, npm package `styled-markdown`, agent skills, GitHub release) without breaking existing users. Use this skill for any change destined for the public bislink360/styled-markdown repository — starting a feature or fix branch, preparing or reviewing a pull request, bumping versions, writing the changelog, checking backward compatibility, tagging, or publishing to the VS Code Marketplace, Open VSX, npm or GitHub…

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

# Releasing Styled Markdown

One repository ships four artifacts that must stay in lockstep:

| Artifact | Where | Version source |
|---|---|---|
| VS Code extension `bislink360.styled-markdown` | VS Code Marketplace, Open VSX + `.vsix` on GitHub Releases | `extension/package.json` |
| npm package `styled-markdown` (library + `smd` CLI) | npmjs.com | `npm/package.json` (same version) |
| Agent skills `styled-markdown-reader` / `-writer` | `skills/`, zips on GitHub Releases | bundle the CLI, so they follow the same version |
| Format spec | `smd: 2` in new documents (`smd: 1` documents keep the v1 rules) | `SMD_VERSION` in `extension/src/core/spec.ts`; changes only for format-breaking releases |

Existing documents, CI pipelines (`smd validate`), library users and agents all depend on today's behaviour. **The primary goal of this process is that nothing breaks silently.** Every incompatible change is found by the checker, called out to the human, and shipped only as a major version.

## Workflow

### 1. Branching: follow the release train (version-control skill)

Branches follow the **version-control** skill's release train:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bislink360/styled-markdown/smd-release@sha256:7b48f82a8610be85

The line at the top of this page pins the label git:20261031.87b660a, 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_pncet6v7ucg7o4a7.svg)](https://markdownregistry.com/a/art_pncet6v7ucg7o4a7)

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

Versions

The registry has recorded 10 versions of this file, between Sep 28, 2026 and Oct 31, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261031.87b660a latest2026-10-31 87b660a 17,387 BA view · diff
git:20261031.2ff6a0e2026-10-31 2ff6a0e 16,498 BA view · diff
git:20261022.2184a112026-10-22 2184a11 16,230 BA view · diff
git:20261018.ab0499c2026-10-18 ab0499c 16,057 BA view · diff
git:20261012.ded8bb52026-10-12 ded8bb5 16,014 BA view · diff
git:20261011.a94263d2026-10-11 a94263d 15,553 BA view · diff
git:20261010.fce5f262026-10-10 fce5f26 15,259 BA view · diff
git:20261001.dca88002026-10-01 dca8800 14,512 BA view · diff
git:20260929.1fabbec2026-09-29 1fabbec 9,891 BA view · diff
git:20260928.4106eef2026-09-28 4106eef 9,205 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 (17387 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

bislink360/styled-markdown · 3 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_pncet6v7ucg7o4a7
GET https://markdownregistry.com/api/v1/resolve?ref=bislink360/styled-markdown/smd-release
GET https://markdownregistry.com/api/v1/blob/7b48f82a8610be85d98964b9ad19ee0d181ffd9467ce34e086f2b6edb5a9518d

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 bislink360/styled-markdown

sonarqube-scan SKILL.md skill
bislink360/styled-markdown · .claude/skills/sonarqube-scan/SKILL.md · Run static code analysis on the Styled Markdown repository with a local SonarQube server in Docker Compose, and gate…
git:20260929.1fabbec · audit A · 3 stars
version-control SKILL.md skill
bislink360/styled-markdown · .claude/skills/version-control/SKILL.md · Plan and run a release train in the Styled Markdown repository. Given a list of features for a release (e.g. "1.2.0…
git:20261001.dca8800 · audit A · 3 stars
AGENTS.md@docs AGENTS.md file
bislink360/styled-markdown · docs/AGENTS.md
git:20261031.2ff6a0e · audit A · 3 stars
styled-markdown-reader SKILL.md skill
bislink360/styled-markdown · skills/styled-markdown-reader/SKILL.md · Read Styled Markdown (.smd) files with few tokens. Use it whenever you need anything from a .smd file (answering…
git:20261031.2ff6a0e · audit A · 3 stars
styled-markdown-writer SKILL.md skill
bislink360/styled-markdown · skills/styled-markdown-writer/SKILL.md · Create and edit Styled Markdown (.smd) documents (PRDs, ADRs, RFCs/design docs, runbooks, API references, status…
git:20261031.2ff6a0e · audit A · 3 stars

Every file in bislink360/styled-markdown

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