feat: roadmap page + skills.sh integration + READMEs republish prep#2
Merged
Conversation
…blish prep
Three landings in one branch (small, contained, easy to review):
**1. /docs/roadmap page**
- New `apps/site/content/docs/roadmap.mdx` covering condition contracts,
storage adapters, framework adapters, scaffolder templates, forms, dashboard
surface, agent kit, Story IP integration, distribution, performance + DX.
- Three confidence tags: next (current cycle), queued (1–2 cycles out),
exploring (design not locked).
- Mainnet is explicitly out of scope until Story promotes CDR off testnet.
- New `<RoadmapTable>` component (`components/docs/roadmap-table.tsx` + .css)
with status-coded left borders, anchor links per row, 2-col grid on
≥720px and 1-col below. Registered in `lib/mdx-components.tsx`.
- Sidebar entry under "Getting started".
**2. skills.sh integration (Vercel Agent Skills)**
- 11 SKILL.md files surfaced at repo-root `skills/` (via copy, with a
source-of-truth comment pointing back at packages/plugin/cdr-kit/skills/).
The original installer path `cdr skill install` continues to work
unchanged — this is additive, not a replacement.
- Every `description:` field rewritten to the Vercel-style numbered-trigger
pattern (`Use this skill when (1)… (2)… (3)… (4)…`) so the cross-agent
pattern-matcher reliably picks them up. Concrete trigger phrases mined
from each skill body — see the subagent's report in the PR description
for the full table.
- README + plugin README now show:
```
## Use the skills from any agent (Claude Code · Cursor · Copilot · Cline · …)
npx skills add Blockchain-Oracle/story-cdr
```
**3. README republish prep — bump 14 packages so pnpm release flushes**
- The READMEs on npm are still the old short ones because each package's
last published version pre-dates the README rewrite. Patch-bumped each:
- cli, tools, mcp, react, react-ui, vercel-ai, openai, langchain,
agentkit, goat: 0.7.0 → 0.7.1
- agent, contracts, core, create-cdr-kit-app: 0.7.1 → 0.7.2
- Single changeset `.changeset/readmes-republish.md` covers all 14. No
code changes; the dists will be byte-identical. Only the README in each
tarball updates.
- Verified gap pre-bump: @cdr-kit/cli source=4886b vs npm=29b. Same shape
across the other 13.
CI parity:
- pnpm install: clean
- pnpm typecheck: 24/24, 24.7s (first run, full)
- pnpm dev → /docs/roadmap renders, sidebar entry present, /skills/* surfaced
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Adds path #1 (skills.sh) above the existing cdr-kit-bundled paths and a Callout explaining how the CLI bundles cdr-kit's 11 skills: - One repo = one 'package' on skills.sh (Blockchain-Oracle/cdr-kit) - Each subdirectory under /skills/ is one installable skill - Default install pulls all 11; --skill <name> picks a subset; --all installs every skill into every detected agent - Update everything later with npx skills update Validated against the live skills CLI: `npx skills add Blockchain-Oracle/cdr-kit --list` reports 'Found 12 skills' (the 11 skills + the root plugin manifest) on the feature/roadmap-page branch.
|
@ajweb3dev is attempting to deploy a commit to the blockchain-oracle's projects team on Vercel, but is not a member of this team. To resolve this issue, you can:
To read more about collaboration on Vercel, click here. |
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
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
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.
Summary
Three landings in one PR (small, contained, easy to review):
1.
/docs/roadmappageapps/site/content/docs/roadmap.mdx— what's next per surface (conditions, storage, adapters, templates, forms, dashboard, agent kit, Story IP, distribution, perf/DX).next·queued·exploring.<RoadmapTable>component with status-coded left borders, anchor links per row, 2-col grid on ≥720px → 1-col below. Registered inlib/mdx-components.tsx.2. skills.sh integration (Vercel Agent Skills)
/skills/so the skills.sh CLI can discover them. Originals atpackages/plugin/cdr-kit/skills/are untouched —cdr skill installcontinues to work.description:rewritten to Vercel-style numbered triggers (Use this skill when (1)… (2)… (3)… (4)…).README.md+packages/plugin/README.mdnow show thenpx skills add Blockchain-Oracle/cdr-kitinstall line./docs/skillgets a 4th install path + a Callout explaining how the CLI packages cdr-kit (one repo = one skill package; subdirectories = individual skills;--skill <name>picks subsets).Validated live against the published feature branch:
3. README republish prep — bump 14 packages
The READMEs on npm are still the old short ones because each package's last published version pre-dates the README rewrite. Diff between source and npm:
@cdr-kit/cli@cdr-kit/agent@cdr-kit/reactPatch-bumped each + single changeset
.changeset/readmes-republish.md. After this PR merges,pnpm releaseflushes all 14 with byte-identical dists; only the README in each tarball updates.Test plan
pnpm install,pnpm typecheck— cleanpnpm dev→/docs/roadmaprenders, sidebar entry present, all status pills color-codedpnpm dev→/docs/skillrenders, new install path visiblenpx skills add Blockchain-Oracle/cdr-kit --listdiscovers all 11 skills on the branchpnpm releaseflushes 14 republished packages with new READMEs🤖 Generated with Claude Code