@spences10/pi-skill-importer

Helpers for importing external Agent Skills-compatible sources into Pi-native skill storage

Packages

Package details

extension

Install @spences10/pi-skill-importer from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@spences10/pi-skill-importer
Package
@spences10/pi-skill-importer
Version
0.0.8
Published
May 26, 2026
Downloads
1,146/mo · 51/wk
Author
spences10
License
MIT
Types
extension
Size
77.5 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ],
  "image": "https://raw.githubusercontent.com/spences10/my-pi/main/assets/pi-package-preview.png"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@spences10/pi-skill-importer

built with Vite+ tested with Vitest npm version license

my-pi package preview

Move external Agent Skills into Pi without hand-copying files. pi-skill-importer provides the import helpers Pi uses to normalize skill metadata, content, and storage from compatible skill sources.

The extension registers /skill-importer with list/import/sync/delete flows. It discovers Claude plugin skills, then copies selected skills into:

$PI_CODING_AGENT_DIR/skills/<skill-name>

Imported copies include provenance metadata so sync can detect upstream changes and refuse to overwrite local edits.

Safety model

External source locations such as ~/.claude/skills and Claude plugin caches are treated as upstream sources. The importer only owns copied Pi-native skills that contain its metadata; it should not delete upstream Claude/plugin directories.

Commands

/skill-importer
/skill-importer list
/skill-importer import <key|name>
/skill-importer sync <key|name>
/skill-importer delete <key|name>

Review external skills before importing: they can instruct agent behavior and tool use. Sync refuses to overwrite local edits, and delete only removes imported Pi-native copies with metadata.

API

import {
	scan_importable_skills,
	import_external_skill,
	sync_imported_skill,
	delete_imported_skill,
} from '@spences10/pi-skill-importer';

Development

Package scripts build transitive workspace dependencies first, then run local tools through Vite+ with vp exec.

pnpm --filter @spences10/pi-skill-importer run check
pnpm --filter @spences10/pi-skill-importer run test

License

MIT