Skip to content

feat: registry pivot foundations#59

Open
harlan-zw wants to merge 3 commits intomainfrom
feat/registry-pivot
Open

feat: registry pivot foundations#59
harlan-zw wants to merge 3 commits intomainfrom
feat/registry-pivot

Conversation

@harlan-zw
Copy link
Copy Markdown
Collaborator

🔗 Linked issue

Part of the skilld.dev registry pivot (no single issue, strategic change).

❓ Type of change

  • 📖 Documentation
  • 🐞 Bug fix
  • 👌 Enhancement
  • ✨ New feature
  • 🧹 Chore
  • ⚠️ Breaking change

📚 Description

Lays the CLI foundations for pivoting skilld from "generate skills from docs" to "curated registry at skilld.dev." No breaking changes; bare names still work with a deprecation warning.

Prefix parser (src/core/prefix.ts): classifies skilld add inputs into typed sources:

  • npm:vue → package skill from registry
  • gh:owner/repo or github:owner/repo → git skill
  • @handle → curator (stubbed, coming soon)
  • @handle/collection → collection (stubbed, coming soon)
  • Bare vue → deprecated, warns and resolves as npm:vue

Registry client (src/registry/client.ts): stubbed API client for skilld.dev. Returns null until the API is live, so all npm: adds gracefully fall through to the existing doc generation pipeline.

Registry install flow (src/commands/sync-registry.ts): simplified install path for registry skills: fetch SKILL.md → write to disk → lockfile with source: 'registry' → link to agents. No LLM, no doc crawling.

Author command nesting: authoring commands moved under skilld author:

  • skilld author package (was skilld author)
  • skilld author publish (was skilld upload)
  • skilld author eject (was skilld eject)
  • skilld author validate (was skilld validate)
  • skilld author assemble (was skilld assemble)

Old top-level commands forward with deprecation warnings.

Lockfile compat: readLock() normalizes legacy source: 'npm' to source: 'registry'.

16 new unit tests for the prefix parser.

…stry client)

Lays groundwork for the skilld.dev curated registry pivot:

- Prefix-based `add` syntax: `npm:vue`, `gh:owner/repo`, `@curator`, `@curator/collection`
- Bare names deprecated with warning, resolve as npm:
- Registry-first install flow: check skilld.dev before doc generation
- Author commands nested under `skilld author` (package, publish, eject, validate, assemble)
- Old top-level commands (eject, validate, assemble, publish, upload) forward with deprecation warnings
- Lockfile normalizes legacy `source: npm` to `source: registry`
- Registry client stubbed (returns null until API is live, graceful fallback)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant