feat(skills): persona/JTBD taxonomy, curl-able hosting, catalog browser, b2c-operator plugin#508
Draft
clavery wants to merge 1 commit into
Draft
feat(skills): persona/JTBD taxonomy, curl-able hosting, catalog browser, b2c-operator plugin#508clavery wants to merge 1 commit into
clavery wants to merge 1 commit into
Conversation
…er, b2c-operator plugin Refactor agent-skill presentation and delivery, adapting Sentry-for-AI's curl-first distribution while keeping our local-skill harness model. - Taxonomy (hybrid): per-skill persona/category/tags in SKILL.md frontmatter (source of truth), closed vocabulary in skills/taxonomy.schema.json (CI-enforced), generated skills/taxonomy.generated.json consumer manifest. Two active personas — developer (41) + operator (16) = 57 governed skills. - Curl hosting: docs build publishes the whole skills/** tree + skills-index.json + skills.txt with absolute URLs and a "curl, don't WebFetch" fidelity note. - Interactive catalog: <skills-catalog /> Vue browser (persona tree + tag cloud + per-card/batch copy curl) embedded on /guide/agent-skills. - Page split: install detail moved to /guide/install-skills; showcase slug kept. - b2c-operator plugin: a generated, committed bundle of the 16 operator skills, registered across plugins.json/marketplace/SDK SkillSet/CLI. - Validators: scripts/validate-skills.mjs (--check), assemble-personas.mjs (--check drift), check-skills-hosting.mjs, check-doc-anchors.mjs; new CI job. - Fix 6 pre-existing off-by-one cross-plugin links in the SCAPI skills and a stale anchor in cli/logs.md. Plan of record: PLAN_SKILL_PRESENTATION.md
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.
Refactor of how we present and deliver agent skills, adapting Sentry-for-AI's curl-first distribution while keeping our local-skill harness model. Plan of record:
PLAN_SKILL_PRESENTATION.md.What changed
Taxonomy (hybrid metadata)
persona/category/tagsnow live in eachSKILL.mdfrontmatter (source of truth, edited with content). The SDK parser ignores them, so this is non-breaking across all IDE targets.skills/taxonomy.schema.json(CI-enforced — frontmatter can't invent buckets).skills/taxonomy.generated.json(committed, DO-NOT-EDIT, freshness-checked in CI).merchantis defined butactive: false(deferred).Curl-able hosting
skills/**tree (SKILL.md + everyreferences/*.md) plus a machine-readableskills-index.jsonand an agent-friendlyskills.txt, with absolute URLs and a "usecurl -sL, not WebFetch" fidelity note. Cold agents / CI can fetch guidance with no install.Interactive catalog
<skills-catalog />Vue browser embedded on/guide/agent-skills: persona→category tree, tag cloud, search, and one-click copycurlper skill or for all matches. Build-time data loader (SSR-safe, no runtime fetch).Doc page split
/guide/agent-skillsis now a quick-start-first showcase (keeps its slug — the most-linked URL); exhaustive per-IDE install detail moved to a new/guide/install-skillspage. Inbound anchors repointed.b2c-operatorpersona pluginscripts/assemble-personas.mjsfrom the 16 operator-tagged skills (deploys, sandboxes, jobs, logs, debugging, edge/MRT, access admin) drawn acrossb2c-cli/b2c. Generated + committed (DO-NOT-EDIT), with a CI drift check. Each skill is still authored once in its home plugin.skills/plugins.json(flaggedgeneratedso it's published but not double-counted),.claude-plugin/marketplace.json, the SDKSkillSet/SKILL_SOURCES/ReleaseInfo, version sync, and a CLI overlap warning.Tooling & guards (new CI
skillsjob)scripts/validate-skills.mjs --check(frontmatter + reference-link resolution + manifest freshness),assemble-personas.mjs --check(drift),check-skills-hosting.mjs(curl URLs resolve),check-doc-anchors.mjs(page-split anchor guard).Incidental fixes
b2c-scapi-shopper/b2c-scapi-admin(../../b2c-cli→../../../b2c-cli).#reading-log-filesanchor indocs/cli/logs.md.Follow-ups (deferred by design)
merchantpersona activation + ab2c-merchantbundle (only 3 merchant skills today).b2c-developerbundle (low value — near-union of existing plugins).