Skip to content
CengridCengridCengrid Docs

Capability examples

The product repository, shelf-b2b/cengrid, ships three small example plugins under examples/. Connect them to a test deployment to see each flow end to end. The organisation GitHub connection must be able to read the repository.

Standing instructions

Section titled “Standing instructions”

examples/standing-instructions is a plugin with two instructions: company-voice and release-practices.

  • Directorystanding-instructions/
    • plugin.json
    • Directoryinstructions/
      • Directorycompany-voice/
        • INSTRUCTIONS.md
      • Directoryrelease-practices/
        • INSTRUCTIONS.md
  1. Open Plugins and connect shelf-b2b/cengrid with the plugin directory examples/standing-instructions.
  2. Open Instructions → Available and add company-voice to Organisation.
  3. Add release-practices to the engineering team only.
  4. Choose Preview effective instructions for each scope to see the combined text the model will receive.

The assignments are explicit choices. Importing never applies an instruction.

Marketplace

Section titled “Marketplace”

examples/marketplace lists three plugins from one repository.

Plugin Shape
release-habits A plugin.json and one skill
writing-voice A plugin.json and one instruction to add at the organisation or a team
inline-skills No plugin.json: the marketplace entry declares its skills path
  1. Open Plugins → Link a marketplace.
  2. Enter the repository shelf-b2b/cengrid and the marketplace directory examples/marketplace.
  3. Link. All three plugins connect, and their items appear under Available on the Skills and Instructions pages.

The third entry has no manifest of its own, so the marketplace entry acts as one:

{
  "name": "inline-skills",
  "source": "./plugins/inline-skills",
  "description": "A plugin with no plugin.json: this entry is its manifest",
  "skills": ["./skills"]
}

Static app

Section titled “Static app”

examples/static-app is a ready-to-publish dashboard with two declared variables.

  1. Connect the repository with the plugin directory examples/static-app.
  2. Open Apps → Available and add report to a team.
  3. Fill in API_BASE_URL (it must match ^https://[^\s]+$) and optionally SHOW_ARCHIVED.
  4. Open the app once its status shows Ready. Change a value later with Configure, then reload the app.

Build your own plugin

Section titled “Build your own plugin”

  1. Create a repository, or a folder in an existing one, with a plugin.json:

    { "name": "team-toolkit", "description": "Shared team capabilities", "version": "1.0.0" }

  2. Add one skill:

    skills/triage/SKILL.md
    ---
    name: triage
    description: Sort new requests by urgency and owner.
    ---
    

    Read the request, decide whether it is urgent, name the team that should own it,
    and reply with both in one short message.

  3. Add one instruction:

    instructions/company-voice/INSTRUCTIONS.md
    ---
    name: company-voice
    description: Use plain language and lead with the outcome.
    ---
    

    Use plain language. Lead with the outcome, keep replies concise, and make the next step clear.

  4. Commit and push, then connect the repository and add the items to a scope.

  5. Edit a file, push, and choose Re-sync to see the change reach every scope that added it.