feat: implement multi-skill architecture for AI coding assistants and add AI Resources documentation#443
Open
yixyxiu wants to merge 9 commits into
Open
feat: implement multi-skill architecture for AI coding assistants and add AI Resources documentation#443yixyxiu wants to merge 9 commits into
yixyxiu wants to merge 9 commits into
Conversation
Add a set of Agent Skills (agentskills.io spec) that teach AI tools how to build on CKB with the CCC SDK: - Hub skill: ckb-ccc-fundamentals (Cell model, package selection, address/amount handling, hallucination guard) - Spoke skills: ckb-ccc-signer-setup, ckb-ccc-transactions, ckb-ccc-udt, ckb-ccc-spore, ckb-ccc-playground, ckb-ccc-examples-finder Installable via `npx skills add ckb-devrel/ccc`. Includes a maintenance README documenting version bump discipline and update workflow.
- Remove packages/docs/public/skill.md (475 lines) - the old monolithic skill file - Add AI Resources section metadata (meta.json and meta.zh.json) - Update llms.txt route to reference skill.md as "Agent skills index" and add AI Resources link - Refactor playground guide Example 2 from UDT token issuance to Spore creation (both EN and ZH) - Update verify-llm.mjs script references This is part of the multi-skill architecture migration where the single skill.md is replaced by a hub skill (ckb-ccc-fundamentals) plus spoke skills for each task domain.
- Add /skill.md route (app/skill.md/route.ts) with hub/spoke skill table, dependencies, and npx skills CLI installation - Add AI Resources section with 4 pages (EN and ZH): - index: overview and navigation cards - set-up-ai-tools: npx skills add installation, keep-skills-up-to-date section - prompting-best-practices: skill-native vs web chat prompt templates, 7 task categories - verify-and-troubleshoot: canary questions, npx skills check/update troubleshooting - Update docs meta.json/meta.zh.json to include AI Resources section - Update introduction.zh.mdx to reference new skill.md endpoint This completes the multi-skill architecture migration by providing the new modular skill structure and comprehensive AI tooling documentation.
- Add XudtSusIssuer class that encapsulates the 3-step SUS flow: 1. Create seal cell (reserved until mint) 2. Create owner cell locked with SingleUseLock bound to seal 3. Consume seal + owner to mint xUDT + UniqueType metadata cells - Add issueXudtWithSUS() convenience function for playground usage - Includes progress callback for tracking each transaction step - Handles TypeId calculation for UniqueType after inputs are finalized
- Update package selection table to show import statement instead of Web Component tag - Clarifies that @ckb-ccc/connector uses standard import pattern like other packages
✅ Deploy Preview for docsccc ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview for liveccc ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
✅ Deploy Preview for appccc ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview for apiccc ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Pull request overview
This PR replaces the previous single, monolithic CCC agent skill doc with a hub-and-spoke “multi-skill” layout under skills/, adds a /skill.md index route that lists skill dependencies and raw URLs, and introduces a new “AI Resources” docs section (EN + ZH) to help developers install, prompt, and verify their AI tooling against CCC docs.
Changes:
- Added a modular Agent Skills set (
ckb-ccc-fundamentalshub + spoke skills for signer setup, transactions, UDT, Spore, playground, and example-finding), plus maintenance guidance inskills/README.md. - Added an on-site skills index (
/skill.md) and updated docs verification +llms.txtto reference the new structure. - Added “AI Resources” documentation pages (setup, prompting, troubleshooting) in both English and Chinese, and updated docs navigation to include them.
Reviewed changes
Copilot reviewed 29 out of 29 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| skills/README.md | Maintenance guidance for updating skills and versioning. |
| skills/ckb-ccc-fundamentals/SKILL.md | Hub skill covering CKB/CCC fundamentals and doc/API-grounding workflow. |
| skills/ckb-ccc-signer-setup/SKILL.md | Spoke skill for wallet connection + signer creation patterns. |
| skills/ckb-ccc-transactions/SKILL.md | Spoke skill for CCC transaction composition pipeline and chain querying. |
| skills/ckb-ccc-udt/SKILL.md | Spoke skill for UDT/xUDT issuance/transfer patterns (SUS issuance example). |
| skills/ckb-ccc-spore/SKILL.md | Spoke skill for Spore/DOB creation/transfer/melt and DOB conventions. |
| skills/ckb-ccc-playground/SKILL.md | Spoke skill for CCC Playground usage, sharing, and contribution workflow. |
| skills/ckb-ccc-examples-finder/SKILL.md | Spoke skill for locating existing example code by category. |
| packages/examples/src/issueUdtSus.ts | New runnable example implementing xUDT SUS issuance flow with progress callback. |
| packages/docs/scripts/verify-llm.mjs | Updates verification checks to validate the new /skill.md route content. |
| packages/docs/public/skill.md | Removes the old monolithic skill document. |
| packages/docs/app/skill.md/route.ts | Adds /skill.md route that renders the skills index table + summaries. |
| packages/docs/app/llms.txt/route.ts | Updates llms notes and adds AI Resources to the index. |
| packages/docs/content/docs/meta.json | Adds AI Resources pages to the English docs navigation. |
| packages/docs/content/docs/meta.zh.json | Adds AI Resources pages to the Chinese docs navigation. |
| packages/docs/content/docs/getting-started/introduction.mdx | Adds AI Resources entry card on the intro page. |
| packages/docs/content/docs/getting-started/introduction.zh.mdx | Adds AI Resources entry card on the intro page (ZH). |
| packages/docs/content/docs/guides/playground.mdx | Updates example #2 to “Create a Spore” (doc snippet). |
| packages/docs/content/docs/guides/playground.zh.mdx | Updates example #2 to “Create a Spore” (doc snippet, ZH). |
| packages/docs/content/docs/ai-resources/index.mdx | New AI Resources section landing page (EN). |
| packages/docs/content/docs/ai-resources/index.zh.mdx | New AI Resources section landing page (ZH). |
| packages/docs/content/docs/ai-resources/set-up-ai-tools.mdx | New page: installing CCC skills into AI tools (EN). |
| packages/docs/content/docs/ai-resources/set-up-ai-tools.zh.mdx | New page: installing CCC skills into AI tools (ZH). |
| packages/docs/content/docs/ai-resources/prompting-best-practices.mdx | New page: prompt templates and grounding workflow (EN). |
| packages/docs/content/docs/ai-resources/prompting-best-practices.zh.mdx | New page: prompt templates and grounding workflow (ZH). |
| packages/docs/content/docs/ai-resources/verify-and-troubleshoot.mdx | New page: canary questions + troubleshooting flow (EN). |
| packages/docs/content/docs/ai-resources/verify-and-troubleshoot.zh.mdx | New page: canary questions + troubleshooting flow (ZH). |
| packages/docs/content/docs/ai-resources/meta.json | New section metadata for AI Resources (EN). |
| packages/docs/content/docs/ai-resources/meta.zh.json | New section metadata for AI Resources (ZH). |
- Add `--all` flag to npx skills add command in skill.md route for non-interactive installation - Add console.log to display Spore ID after creation in playground example (both EN and ZH) - Fix Chinese playground example description from "发行代币" to "创建 Spore" for accuracy
- Change `dependsOn` to `depends-on` in skills/README.md to match the actual YAML frontmatter field name used in SKILL.md files - Add descriptive comment to issueUdtSus.ts example
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.
This PR introduces a modular multi-skill architecture for CCC's AI coding assistant support, replacing the previous monolithic
skill.mdwith a hub-and-spoke structure. It also adds comprehensive AI Resources documentation to help developers configure and use their AI tools effectively with CCC.Changes
Multi-Skill Architecture
AI Resources Documentation
Added a new documentation section with 4 pages (English and Chinese):
npx skills add ckb-devrel/ccc, keep-skills-up-to-date workflowNote: The current prompt templates include detailed constraints to ensure accuracy. We will be conducting deep testing to find the optimal balance between prompt conciseness and output accuracy, and will iterate on these templates based on real-world usage.
npx skills check/updateDocumentation Infrastructure
packages/docs/public/skill.md/skill.mdroute serving a Markdown table with skill dependencies and installation instructionsllms.txtroute to reference the new skill structureExamples
XudtSusIssuerclass for xUDT Single-Use-Seal pattern issuance