Help
How can we help?
Search the help, or browse by topic. Each article is short, says what to click, and links straight to the screen it describes.
Getting started
What Deftro is and the first things to set up.
Your account
Signing in, your profile, notifications, tokens and your data.
Signing in, staying signed in, and signing out
Sign in with Google or GitHub. A sign-in lasts 7 days, and Settings > Security lists every browser signed in as you.Edit your public profile
Settings > Profile changes what people see on your public page at /your-handle, from your name and bio to your avatar and pinned skills.Notifications and notification email
Notifications collect reviews, issues, stars, badges and replies in one place; untick "Email me as well" to stop the email copies.API tokens
Create a personal token in Settings > API tokens for scripts, CI and agents, pick its scopes, copy it once, and revoke it when you are done.Achievements and badges
Badges on your public profile mark what you have shipped and how people use it; the Achievements page shows what the next tier needs.Delete your account or download your data
In Settings > Security you can download everything held about you as a JSON file, or delete your account by typing your handle.
Organisations and people
Organisations, invitations, roles, projects and teams.
Create an organisation
Create an organisation from the Organisations page to share skills, projects and reviews with other people. You become its first owner.Invite people to your organisation
Owners and admins invite people by email or with a shareable link, choose their role, and can scope the invitation to one project.Roles and permissions
Members are owners, admins, editors or viewers; someone invited to one project is a guest. Project and team roles can raise what someone can do, never lower it.Projects
A project lists the skills and prompts one codebase needs and the people who work on it. Admins create and archive projects.Teams
A team groups people already in your organisation and gives them a role. It can raise what its members can do, never lower it.Organisation settings
An organisation's Settings tab holds its name, public page and logo, the review policy, device and browser extension rules, and domain verification.Bring skills in from GitHub
Import skills from your repositories, sync organisation repositories into Review with the GitHub App, import a public skill, or list and claim GitHub skills.
Artifacts and Review
Skills and prompts, versions, Review and the Health check.
Artifacts, skills and prompts
An artifact is a skill or a prompt you store in Deftro. Each has its own page with Overview, History, Issues, Proposals and Compare tabs.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.Versions and publishing
Every change is a new numbered version that only moves forward. A published version never changes; you can yank it to stop new installs, or restore an old one.Review new versions
In an organisation, a new version waits in the Review queue until someone else approves it. You can never review your own version.The Health check
Every version gets a Health check that flags careless and risky patterns. Critical findings stop a publish; a clean report is no guarantee.Your storage quota
Each person can store 100 MB. Check usage in Settings > Usage & plan; free space by deleting Knowledge documents, Context spaces or previews.Your Library and saved artifacts
Press Save on any artifact card or page to keep it in your Library. Only you can see what you saved.Import all your skills from GitHub
Install the Deftro GitHub App on your own GitHub account, pick repositories, and import every skill in them with one click.
Agents and installs
Connecting Claude Code, Cursor and others: the deftro CLI, MCP and the extension.
Connect a coding agent to Deftro
Paste one setup sentence into your agent, or generate an agent brief, then approve the sign-in code on the device page in your browser.Use the deftro command-line tool
Run deftro with npx to sign in, install pinned skill versions into your agent's folders, keep them in sync, and publish your own.Add the Deftro MCP server to your agent
The @deftro/mcp server lets an MCP client search, install, sync and publish skills and read your Knowledge, signed in through deftro login.Insert saved prompts with the browser extension
Save an artifact as a //alias shortcut, sign the extension in with a device code, and type // in ChatGPT, Claude, Gemini or Grok to insert it.See what was installed, and where
The Installs page lists every version you installed and the machine it went to; admins see their organisation's installs and each version's blast radius.
Knowledge, Context and usage
Knowledge collections, Context spaces, usage and Activity.
Give your agents documents to search with Knowledge
Knowledge (Beta) holds text and Markdown documents, private to you or shared with an organisation, that your agents search through the MCP server.Move Baton context between machines
deftro context push uploads Baton memory, plans and handoffs; pull restores them without overwriting your edits.Read Usage and Activity
Usage shows how your artifacts are installed and synced; Activity is the dated record of publishes, reviews, installs and yanks, which admins can export.
Sharing and community
Visibility, proposals and discussions, reports and sponsorship.
Visibility and sharing
Choose who can see an artifact: Private, Shared, Project, Organisation or Public. Share links give a read-only view of the latest published version.Proposals, issues and discussions
Suggest an edit to someone else's artifact with a proposal, report a broken version with an issue, or ask questions in its discussion.Reports and moderation
Report an artifact that looks harmful. Public ones go to Deftro staff, an organisation's private ones to its admins. Staff can also restrict accounts.The community
Ask and show what you built at /community, tag, search, follow and save threads, vote, mark the answer, and report what breaks the rules.Sponsor a placement
Bid for a sponsored slot from the Sponsor area, pay from your wallet, and upload an ad that a moderator reviews before it shows.Ask for a feature or report a problem
Post requests and problem reports on the public Feedback board, vote for others, and use it for help when no article answers your question.Apply to advertise
Apply once from Advertise on Deftro; an admin approves you before you can bid, and you can switch between Developer and Advertiser mode.
Refusals and errors
What a refusal means and what to do next.
You can't see or do that
Why Deftro answers "not found" for things you may not see, and what a conflict means when something already exists or an organisation rule stops a change.Publishing refusals
What each refusal means when a version will not publish, from a bad version number to a missing SKILL.md, and how to fix it.Health check refusals
Your version was not published because the Health check found a credential or text aimed at the agent. Fix the lines it names, then publish again.File and limit refusals
Why a file, image or upload was refused for its type or size, or because a limit was reached, and what to do instead.Review and version refusals
Why a review decision, yank, restore or install was refused, including paused installs, yanked versions and expired GitHub links.Proposal, comment and discussion refusals
Why a proposal, comment, reply or discussion post was refused, and what you can do instead.GitHub, import and listing problems
What each GitHub sync, pull request, import, listing and claim refusal means, and the one thing to do next for each.Too many requests, maintenance and unexpected errors
What to do when Deftro says to slow down, is in maintenance, hits an error of its own, lacks a feature here, or cannot be reached.
Still stuck? Tell us on the Feedback board.