Skip to content
Deftro
Start free
Artifacts and Review

Create or upload an artifact

Press Add to upload a SKILL.md, write a skill or prompt in the editor, or import from GitHub. Every artifact needs a name and a description.

Press Add in the top bar. The Add an artifact panel offers four ways in: Import from GitHub, Upload a file, Create a skill and Write a prompt.

Upload a file

  1. Open Upload & publish artifact.
  2. Drop a SKILL.md on the page, browse for it, or paste it into Raw SKILL.md content. Whatever the file is called on disk, it is published as SKILL.md.
  3. Check Parsed frontmatter readback: it shows the name, kind and the address the artifact will get.
  4. Choose a Destination (only accounts you may publish into are listed), a Visibility and a Version, and add a note if you like.
  5. Press Publish version.

The web upload takes one file. To publish a whole skill folder, run deftro publish inside it. See Use the bv command-line tool.

Write one in the editor

Create a skill and Write a prompt open a blank template. Fill in the frontmatter, write the body, and press Publish private skill or Publish private prompt. You can share it or make it public from the artifact page afterwards.

The frontmatter

SKILL.md must start with a block fenced by --- lines that holds:

  • name: lowercase letters, digits and hyphens, starting with a letter or digit. It becomes the artifact's address.
  • description: required. It is what an agent matches against to decide whether to load the skill, so describe when to use it. A very short one gets a warning.
  • kind: prompt for a prompt. Without it, the artifact is a skill.

Limits

A version holds at most 500 files, each at most 1 MB. Files must be text: executables, archives and binary files are refused. Paths must be relative, with no .., and two paths may not differ only by upper or lower case. Every version also gets a Health check and counts toward your storage quota.

In an organisation, a new version may wait in Review before anyone can install it.

During maintenance

Publishing is paused while Deftro is in maintenance. Your file and the details you entered stay in the form while the page is open, and you can publish when it ends. Skills already installed in your editor keep working.

Checked against the product on .

Related articles