feat: publish tablespec as a Claude Code / Codex plugin marketplace - #20
Merged
Merged
Conversation
…l targets Move .agents/skills/tablespec to skills/tablespec as the source of truth for the forthcoming Claude Code / Codex plugin. .agents/skills/tablespec and .claude/skills/tablespec become symlinks to it (helix pattern), so the skill also autoloads in Claude Code sessions inside this repo. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Rewrite the frontmatter description as a UMF/tablespec trigger instead of a repo-local one, make DDx bead references conditional on a .ddx/ directory, and drop wording that assumed the tablespec repo is the working directory. Technical content (bootstrap composition, happy path, formats, dialects, testing) is unchanged. Codex openai.yaml metadata updated to match. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…t test Publish tablespec as a single-plugin marketplace: .claude-plugin/plugin.json, .claude-plugin/marketplace.json (source "./"), and .codex-plugin/plugin.json, all at version 0.0.3. tests/docs/test_plugin_manifests.py keeps the three versions mutually consistent, pins the marketplace catalog shape, checks the skill frontmatter stays install-agnostic, and verifies the .agents/.claude install-target symlinks resolve to skills/tablespec. Install: /plugin marketplace add https://github.com/DocumentDrivenDX/tablespec /plugin install tablespec@tablespec Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…gin install Add a version-guard job to release.yml that fails the release when .claude-plugin/plugin.json, .claude-plugin/marketplace.json, or .codex-plugin/plugin.json declare a version other than the pushed tag, and make build depend on it. Document the plugin install in README, the skills/ + manifest layout in CLAUDE.md, and the manifest-bump step in the deployment checklist (v2.3). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…ll docs, test hardening - SKILL.md: add a "Getting tablespec" block (index-url install, CLI, docs URL) and split contributor-only guidance into a "When contributing to tablespec itself" section so the skill reads correctly for plugin users in their own repos. - README: replace the incorrect /tablespec claim with /tablespec:tablespec, add the scripted claude CLI form and Codex install commands. - openai.yaml: align short_description with the Codex manifest; new contract test pins skill-level Codex metadata to .codex-plugin/plugin.json. - test_plugin_manifests: allow pre-release versions matching the v*.*.* release trigger, assert Codex description equals the Claude one, require SKILL.md to open with frontmatter. - deployment checklist: refresh Last Updated. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
morficus
force-pushed
the
feat/plugin-marketplace
branch
from
August 29, 2026 22:30
fdb4c12 to
bbffe85
Compare
morficus
marked this pull request as ready for review
August 29, 2026 22:30
morficus
marked this pull request as draft
August 29, 2026 22:32
morficus
force-pushed
the
feat/plugin-marketplace
branch
from
August 29, 2026 22:35
bbffe85 to
7055070
Compare
morficus
marked this pull request as ready for review
August 29, 2026 22:55
…test that pre-commit flags
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this does
Publishes the tablespec agent skill as a Claude Code and Codex plugin, following the layout
DocumentDrivenDX/helixalready uses:skills/tablespec/SKILL.mdis the published skill;.agents/skills/tablespecand.claude/skills/tablespecare symlinks into it. Its text was rewritten to read correctly outside this repo. Three manifests declare the plugin at0.0.3.Before tagging a release
Bump
versionin all three manifests to match the tag. Claude Code refreshes an installed plugin only whenplugin.jsondeclares a newversion, so a stale manifest ships nothing and reports no error. The newversion-guardjob fails the tag push when they disagree, andtests/docs/test_plugin_manifests.pykeeps them consistent at PR time.What this does not do
src/orapps/changed, and no dependency file changed.hooks/hooks.json.Verification
claude plugin validate .passes. A fresh clone of this branch installs at 0.0.3 with one skill. The guard exits 1 on a mismatched tag.make testreports 3700 passed and 120 skipped.The GitHub clone path stays untested until merge. If
"source": "./"fails there, switch to theurlform.🤖 Generated with Claude Code