Add installSkill() to SDK for skill lifecycle management
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 45/100
- Issue type
- Feature
- Clarity
- Clearly specified
- Activity status
- Stale
- Tech stack
- typescript
Research direction
Start with the existing install flow in packages/cli/src/commands/skills/install.ts and trace the SDK facade and downloadSkillBundle() implementation to see where the install lifecycle belongs. Compare the existing CLI behavior with the proposed options and acceptance criteria, then inspect the SDK’s unit test conventions. Done when the SDK method installs and verifies a skill, handles overwrite and cleanup, reports the specified errors, and the CLI uses it.
Written by the indexing model from the issue text.
Description
Summary
The SDK currently supports downloading skill bundles (client.downloadSkillBundle()) but has no method for the full install lifecycle — extracting to the correct directory, handling overwrites, and verifying the result.
The CLI implements this in packages/cli/src/commands/skills/install.ts with:
- Download via
mpak.client.downloadSkillBundle() - Write to temp file
- Extract with
unzip -oto~/.claude/skills/ - Force/overwrite handling
- Cleanup of temp files
This should move to the SDK so that platform consumers (e.g., mcp-operator, integration-manager) can install skills programmatically without shelling out to the CLI.
Proposed API
interface InstallSkillOptions {
/** Target directory for skills (default: ~/.claude/skills/) */
skillsDir?: string;
/** Overwrite existing installation */
force?: boolean;
/** Specific version (default: latest) */
version?: string;
}
interface InstallSkillResult {
name: string;
shortName: string;
version: string;
installPath: string;
}
// On the Mpak facade:
async installSkill(name: string, options?: InstallSkillOptions): Promise<InstallSkillResult>
Acceptance Criteria
-
Mpak.installSkill()downloads, verifies, extracts, and returns install metadata - Handles
forceoption for overwriting existing installations - Cleans up temp files on success and failure
- Throws
MpakNotFoundErrorif skill doesn't exist - Throws
MpakInvalidBundleErrorif extraction fails - Unit tests with mocked client
- CLI
skill installcommand updated to use SDK method
Context
Needed for the NimbleBrain platform to use the SDK directly instead of shelling out to the CLI. See also: platform migration plan for mcp-operator integration.
- Dominant language
- TypeScript
- Stars
- 14
- Forks
- 13
- Avg merge
- 16m
- Merged PRs (30d)
- 4
Getting set up
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from NimbleBrainInc/mpak
-
Difficulty 1/5 Under an hour Newbie friendliness 88/100
NimbleBrainInc/mpak#180 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
NimbleBrainInc/mpak#175 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 73/100
NimbleBrainInc/mpak#159 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 64/100
NimbleBrainInc/mpak#120 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
NimbleBrainInc/mpak#112 ·
All issues in NimbleBrainInc/mpak
Similar issues
-
bug documentation
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day
-
Potential Bug
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Comfy-Org/ComfyUI_frontend#23773 ·
Maintainers usually reply within 1 day
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
Difficulty 1/5 Under an hour Newbie friendliness 85/100
lingdojo/kana-dojo#34301 · 1 comment · 5 reactions ·
Maintainers usually reply within 1 day
-
code-quality refactoring
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
github/gh-aw-firewall#11797 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
code-yeongyu/senpi#7007 ·
Maintainers usually reply within 1 day