Add skill distribution specification for katalyst#20
Merged
Conversation
abegong
force-pushed
the
claude/practical-mayer-uuo45q
branch
3 times, most recently
from
d43f7a7 to
bbd61c3
Compare
✅ Deploy Preview for stately-starburst-216875 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Spec for a family of user-facing katalyst skills aligned to the content lifecycle (catalog, define, enforce, reshape), each committed under skills/ and versioned with the CLI. Ships as one .skill artifact per skill attached to GitHub Releases for Git-free install, with marketplace plugins as an additive later channel. Scoped to katalyst's release cycle; skills stay self-contained and independent of the how-to guides. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WbdvMAh571kvviysmRqmaQ
Fold the four decisions into the design: the shared bootstrap fetches the CLI binary from the latest Release (no embedding); define splits into two cross-referencing skills (identify-collections, define-schemas); Channel 1 (.skill on Releases) is in scope while Channel 2 (marketplace) and skill-CLI version coupling are deferred. Open Questions now empty. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WbdvMAh571kvviysmRqmaQ
Companion plan to skill-distribution-spec.md: seven phases that stand up the distribution pipeline (scaffold skills/, make skills packaging, fetch-based bootstrap, tag-triggered release workflow, dev symlink) before authoring the five lifecycle skills, then verify and graduate. Channel 2 and version coupling stay out of scope per the spec. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WbdvMAh571kvviysmRqmaQ
Drop reshape from the initial family until its content exists (it re-enters later through the additive pipeline). Replace the enforce skill with deploy: rather than a loop the agent re-runs on every write, deploy sets up automatic enforcement once — a pre-commit hook running katalyst check, or CLI-gated directory access — so the guardrail is structural, not discretionary. Update the spec and plan accordingly. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WbdvMAh571kvviysmRqmaQ
- Add an overview orientation/router skill (katalyst's model + vocabulary, routes to task skills; distinct from catalog). - Make Enforce a cluster: deploy (umbrella, knows both mechanisms) plus deploy-precommit-hook and deploy-cli-gating as the specific setups. - Replace the deferred reshape skill with two Reshape-stage placeholders, migrate-schema and migrate-storage, committed as status:placeholder stubs and excluded from packaging/release until they have content. - Update plan: pilot is the deploy cluster; packaging skips placeholders. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WbdvMAh571kvviysmRqmaQ
Prefix every skill (name, .skill artifact, and skills/ directory, kept 1:1) to disambiguate and group the family in the client's flat skill namespace; chosen over a -with-katalyst suffix, which would scatter them by action letter. Record the convention and rationale in the spec; reflect it across the spec and plan. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WbdvMAh571kvviysmRqmaQ
Update the Phase 7 locked-rationale list: drop the stale "per-stage family" descriptor and add the katalyst- naming convention and deploy-as-setup, so the content destined for deep-dives reflects the family as it now stands. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WbdvMAh571kvviysmRqmaQ
Record that the release job authenticates with the built-in GITHUB_TOKEN via permissions: contents: write (no PAT/secret), add a workflow_dispatch dry-run trigger, and note the two owner-only items: the Workflow-permissions settings caveat and pushing the version tag to cut a release. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WbdvMAh571kvviysmRqmaQ
abegong
force-pushed
the
claude/practical-mayer-uuo45q
branch
from
bbd61c3 to
73d9771
Compare
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
3 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.
Summary
This PR updates the skill distribution spec and implementation plan for shipping user-facing katalyst skills as versioned product artifacts. The branch now describes the current intended family, packaging contract, release path, bootstrap behavior, and follow-up owner actions after being rebased onto latest
main.Key Changes
katalyst--prefixed family underskills/:katalyst-overview,katalyst-catalog,katalyst-identify-collections,katalyst-define-schemas,katalyst-deploy,katalyst-deploy-precommit-hook, andkatalyst-deploy-cli-gating.katalyst-migrate-schemaandkatalyst-migrate-storageasstatus: placeholderstubs that are committed but excluded from packaging until they have real content.enforceskill with a deploy cluster that sets up automatic enforcement once, either through a pre-commit hook or CLI-gated directory access.katalyst-overviewas the family front door/router for katalyst vocabulary, workflow, and task-skill selection.make skillsandmake skill SKILL=<name>for producing.skillarchives withSKILL.mdat the archive root, skipping placeholder skills..skilldownloads attached to GitHub Releases, with marketplace plugins deferred as a later channel.go installas fallback, instead of embedding binaries in each skill.Notes
mainat3a44ff1.v*tag, confirm assets, install a downloaded.skill, then graduate durable docs and retire the spec/plan.https://claude.ai/code/session_01WbdvMAh571kvviysmRqmaQ