Bring skills in from GitHub

Import from your own repositories

To import everything at once, use Import from GitHub. See Import all your skills from GitHub. To scan one repository at a time:

1. In Settings > Integrations, press Connect GitHub. It is a read-only grant to your repositories.
2. Open Import from GitHub and pick a repository to scan.
3. Choose the skills and a destination, then press Import. A critical Health check finding blocks that skill. Imported skills start private, and skills from a private repository can never be made public by an import.

Sync an organisation's repositories

Owners and admins open their organisation, then GitHub.

1. Press Install on GitHub and install the Deftro GitHub App on the repositories that hold your skills.
2. Under Linked Repositories, press Add link and pick the installation, the repository and a Deftro project.
3. From then on, pushes to the repository's default branch that change a skill become new versions waiting in Review.

With PR-back on for a link, an approved version offers Open pull request to send the change back. The GitHub App then needs write access to contents and pull requests.

Import a public skill into your organisation

Members who can publish open their organisation, then Imports.

1. Paste the skill's GitHub URL and choose a Target Project.
2. Press Preview Skill. You see the commit, the Health check result and the licence.
3. Press Import to Review. The previewed copy waits in Review and cannot be installed until approved.

List someone else's skill

To add someone else's public skill, use List a skill from GitHub. It is listed under its author's GitHub name, not yours. Only public repositories, folders with a SKILL.md, and licences that allow copying are accepted, and every skill goes through the Health check. New commits become new versions on a later refresh.

Claim a listing of your skill

A listed skill's page says "Is this yours?". Press Claim this listing, then:

1. Prove you own the repository. Either connect a GitHub account that administers it (admin, not just push) in Settings > Integrations, or install the Deftro GitHub App on the GitHub account that owns it from Import from GitHub. A file committed to the repository no longer counts, because anyone with push access could add one.
2. Choose where the skills go, and press Claim this listing. They keep their versions, stars and installs.

Something refused? See GitHub and import problems.