Skip to main content
<- Docs home

Guides

Import Skills

Import Skill packages, Skill files, and supported public sources while keeping validation, provenance, and review state explicit.

Audience
Users moving local or public Skills into a governed workspace.
Updated
2026-05-20

Import turns an existing Skill into a validated Fygment package. Start with one selected package or public source and review the validation result before broader migration.

Supported import sources

Fygment supports ZIP/package upload, standalone Skill files, public GitHub/GitLab repositories, public npm packages, and public ZIP URLs through the external-source import stack.

External-source preview/import and AI-assisted normalization are Advanced / Teams actions. Solo workspaces keep local package upload, creation, install, and check basics.

Imports read from public sources. For a private repository or a credentialed package registry, upload the package or Skill file instead.

Import flow

  1. 1

    Preview the source

    For repository sources, Fygment detects candidate Skill packages and shows validation status, file counts, risks, and checksums before import.

  2. 2

    Select one candidate

    When more than one candidate exists, choose the package path explicitly. Fygment does not guess which folder to publish.

  3. 3

    Import into review or current state

    Owner/admin imports can become current when policy allows. Member imports and normalized drafts remain pending review.

Privacy

Import diagnostics are redacted

Diagnostics and support reports must omit raw package bodies, raw Skill files, prompts, tokens, credentials, local paths, stdout, stderr, and full stack traces.

Related docs

  • Create a Skill

    The creation flow gives you a valid starting package so you can focus on useful instructions instead of hand-building manifest state.

  • Review and approve Skills

    Governance is the difference between a shared Skill library and a loose pile of files. Review decisions decide what can be installed and trusted.

  • Install Skills in Codex

    Codex is a writable install target. Use the guided CLI path so Fygment can preview config changes and track install state.