SkillPortSkillPort

CLI Reference

Complete command reference for the skillport CLI

Install:

npm install -g @skillport/cli

skillport init

Generate an Ed25519 signing key pair. Keys are stored in ~/.skillport/keys/.

$ skillport init

skillport export

Export a skill directory as a signed .ssp package. Runs security scan and blocks if critical issues are found.

$ skillport export <path> -o <output.ssp>
-o, --output <file>Output file path (required)
--strip-secretsAutomatically remove detected secrets instead of blocking

skillport scan

Run the security scanner on a skill directory or .ssp file. Returns exit code 0 (pass), 1 (fail), or 2 (warn).

$ skillport scan <path|file.ssp>
--jsonOutput scan report as JSON

skillport sign

Add or update the Ed25519 signature on an existing .ssp package.

$ skillport sign <file.ssp>
--key <id>Key ID to use (defaults to ~/.skillport/keys/default)

skillport verify

Verify signatures and checksums of a .ssp package.

$ skillport verify <file.ssp>

skillport install

Install a skill from a local .ssp file or from the marketplace. Verifies signatures, re-scans, and prompts for permission consent.

$ skillport install <file.ssp | id@version>
--accept-riskRequired for skills with shell=true or critical danger flags
--skip-scanSkip local re-scan (not recommended)

skillport dry-run

Run all verification and compatibility checks without actually installing.

$ skillport dry-run <file.ssp>

skillport uninstall

Remove an installed skill.

$ skillport uninstall <author/skill-name>
-y, --yesSkip confirmation prompt

skillport login

Authenticate with SkillPort Market. Supports --yes --no-browser (print URL), --port 0 (auto-select free port), --method token --token (direct token login).

$ skillport login

skillport publish

Upload a .ssp package to the marketplace. Requires authentication.

$ skillport publish <file.ssp>
--price <cents>Price in USD cents (0 for free)

skillport convert

Convert a skill between OpenClaw and Claude Code formats. Auto-detects source platform. Supports --preserve-meta for lossless round-trip.

$ skillport convert <path> --to <platform>
--to <platform>Target: openclaw, claude-code, or universal
--preserve-metaPreserve metadata comments (default: true)
--dry-runShow conversion without writing files

skillport plan

Preview install changes without applying. Shows files added/updated/removed, security summary, and rollback command. Agents use this for Plan → Apply workflow.

$ skillport plan <target>
--projectPlan for project-local install
--globalPlan for user-global install
--jsonOutput as JSON

skillport inspect

View detailed metadata, security info, and quality score of a local .ssp file or marketplace skill.

$ skillport inspect <file.ssp | id@version>
--jsonOutput as JSON

skillport suggest

Get skill recommendations from the marketplace based on a task description.

$ skillport suggest "<task description>"
--jsonOutput as JSON

skillport list

List your installed skills or browse marketplace skills.

$ skillport list
--jsonOutput as JSON

skillport manage

Manage marketplace skills: publish, pause, delete, set-price. Requires authentication.

$ skillport manage <id> <action>
set-price <cents>Set price in USD cents
publish | pause | deleteChange skill status

skillport whoami

Show current CLI configuration and authenticated user.

$ skillport whoami

skillport doctor

Check CLI setup health: keys, login status, API connectivity.

$ skillport doctor

skillport keys register

Register your signing public key with the marketplace.

$ skillport keys register

skillport replay

View stored execution traces. Use 'replay list' to see all traces or 'replay <trace-id>' for details.

$ skillport replay <trace-id | list>
--jsonOutput as JSON

skillport eval

Evaluate skill quality from stored execution traces. Shows success rate, duration stats, and token usage.

$ skillport eval <skill-id>
--runs <n>Limit to last N traces
--jsonOutput as JSON

skillport feedback

Submit execution feedback (success/failure/error) for a skill to the marketplace.

$ skillport feedback <skill-id> --status success
--status <status>success, failure, or error (required)
--trace <id>Link to a trace ID
--comment <text>Optional comment