publish

Publish an agent

Turn an agent you use into a template anyone can install. The process strips personal data and creates an example run with fabricated names. Your procedure stays, your secrets do not.

Before you start

  • A gcontext instance with an agent module you want to share.
  • At least one completed run in the module's runs/ folder.
  • Claude Code (the skill runs as a Claude Code conversation).

How it works

1

Open Claude Code in your agent's project

Navigate to the project where your gcontext agent lives. The agent must have at least one agent module with a completed run in runs/.

2

Paste the share-agent skill

Copy the skill URL below and paste it into Claude Code. The skill walks you through packaging: it reads your agent, classifies every personal element, and asks you to confirm before it changes anything.

3

Claude packages the template

The skill replaces personal data with parameter slots, rewrites service-specific references to generic descriptions, and generates a setup command. Your steps stay structurally identical; only the specifics change.

4

Claude creates the example run

A fabricated run with fake names and plausible data is generated from your most representative real run. This example is what visitors see on the marketplace page.

5

Submit via pull request

Run gcontext share <template-folder> to validate locally and print the PR steps. Then open a pull request against github.com/bleak-ai/agents that adds one folder at the repo root. A maintainer reviews and merges it. Your agent appears in the directory after the merge.

skill url
https://raw.githubusercontent.com/bleak-ai/gcontext/main/docs/share-agent.md
validate locally
gcontext share <template-folder>

What gets shared, and what does not

Included

  • Steps (procedure with parameter placeholders)
  • Functions (reusable scripts, if any)
  • Setup command (personalizes the agent for a new user)
  • Example run (fabricated data, same structure as a real run)
  • Manifest (name, description, tags, parameters, connection requirements)

Never included

  • Secrets and credentials
  • Real run traces with your data
  • Playbooks learned from your systems
  • Personal names, domains, or account identifiers
  • Files outside the agent module

The share-agent skill handles the full process: eligibility checks, slot extraction, template generation, example fabrication, leak scanning, and submission. For the complete reference, read the full skill document on GitHub.