Skip to content
cccskills
FreePublished on GitHub

observal-agents

Create and install Observal Agents, edit their definitions, and manage publication and version releases. The skill also supports forking approved Agents, archiving and restoring them, transferring ownership, and managing co-authors.

OriginalShow the original description

Creates, forks, authors, validates, publishes, updates, versions, pulls, archives, restores, transfers, and manages co-authors for Observal Agents. Use when the user wants to build or install an Agent, change an Agent definition, publish a draft, release a version, or manage Agent ownership.

Works withGmail
See how to install

Good for

  • Create and publish an Agent
  • Install an existing Agent
  • Customize an approved Agent
  • Release a new version
  • Transfer ownership or manage co-authors

Files included (2)

  • SKILL.md3.3 KB
  • references/agent-workflows.md10.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Managing Observal Agents

Execution contract

  1. Execute commands with a 60 second timeout.
  2. Use machine output by default: add --output json whenever supported. Parse list results from items and pagination fields.
  3. Use --help before acting when a path or flag is uncertain.
  4. Keep workflows noninteractive. Supply required fields, --no-prompt, and confirmation flags.
  5. Use UUIDs or qualified_name values returned by JSON. Never automate with row numbers.
  6. Prefer native agent init, agent add, and agent build over hand-written scaffolding or custom validation.
  7. Verify every publish, release, pull, ownership, and lifecycle mutation.
  8. Never print MCP environment values, headers, tokens, or other secrets.
  9. Mutations are sent once. After an uncertain transport failure, read Agent state before retrying.

Choose the workflow

User intentWorkflow
Find or inspect an AgentDiscover and inspect
Install an existing Agent into a harnessPull and verify
Create a simple Agent in one callDirect create
Customize an approved Agent without changing its sourceFork and edit
Author an Agent with components or filesInit, add, build, publish
Change the current listing without a new reviewed versionUpdate in place
Publish a reviewed patch, minor, or major versionRelease
Create many Agents from a prepared fileBulk create
Archive, restore, transfer, or manage co-authorsLifecycle and collaboration

Read Agent workflows completely before executing the selected workflow.

State rules

  • create without complete flags starts a wizard. Agents must provide all required inputs or use a file.
  • fork copies only an approved source release into a new independent draft. An inaccessible source is shown as Source unavailable, never as a saved source reference.
  • publish --update changes the current Agent in place. A fork scaffold uses agent_id to target its draft, not a similarly named approved Agent.
  • release --bump creates a reviewed version. Do not use update when the user asked for a release.
  • Public teamspace publication may remain private with a pending visibility or listing review. Report the actual returned status.
  • Pull success requires checking files, warnings, and setup_commands. Partial setup is not success.
  • A 409 is a decision point, not a generic retry signal. Read current state before choosing update or release.

Completion

Report the canonical Agent identity, resulting status and version, files changed for local operations, warnings, and the smallest next action. Verify with agent show, agent versions, or scan when the mutation response is not sufficient.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

observal

FreeSummary

Find and reuse organization-approved skills, prompts, tool connections, and Agents through Observal. Check existing installations, select resources suited to the task, and handle account setup, shared Agents, inbox items, and teamspace membership through the CLI.

  • Finding approved resources for a task
  • Checking installed skills and tool connections
  • Configuring login and the local Agent environment
Observal/Observal4.6KUpdated Oct 20, 2026

observal-admin

FreeSummary

Administer Observal users, settings, submission reviews, identity configuration, and security investigations. Also manage local server upgrades, rollback, and database schema migrations, checking the resulting state and protecting sensitive values throughout privileged operations.

  • Managing users, permissions, and submission reviews
  • Configuring SAML sign-in and SCIM user provisioning
  • Investigating security events and audit logs
Observal/Observal4.6KUpdated Oct 20, 2026

Recover missed Observal session deliveries, upgrade or downgrade the command-line tool, and roll back version changes. After specified connection or configuration failures, it can also create local Agent files when explicitly requested.

  • Recover missed session deliveries
  • Upgrade or downgrade the CLI
  • Roll back a CLI version change
Observal/Observal4.6KUpdated Oct 20, 2026

observal-ops

FreeSummary

Inspect Agent activity in Observal through execution records, sessions, ratings, logs, and insight reports. Use the evidence to investigate telemetry problems, costs, and performance regressions, then identify practical next steps while accounting for limited data.

  • Reviewing recent Agent activity
  • Diagnosing missing telemetry
  • Investigating costs and performance regressions
Observal/Observal4.6KUpdated Oct 20, 2026

Find, evaluate, and install agent components from Observal, including skills, MCP servers, hooks, and prompts. For components you control, the skill also supports bulk submission, version management, archiving, restoration, ownership transfers, and co-author management.

  • Find and install components for an agent environment
  • Get component recommendations for current needs
  • Submit multiple components for review
Observal/Observal4.6KUpdated Oct 20, 2026

release

FreeSummary

Manage Observal maintainer releases, from creating release branches and backporting fixes to preparing preview and stable versions. Follow the existing release workflow to verify published artifacts, inspect release status, and recover interrupted or failed operations.

  • Creating a new release branch
  • Backporting merged fixes to maintained versions
  • Preparing alpha, beta, RC, and stable releases
Observal/Observal4.6KUpdated Oct 20, 2026

See all skills by Observal

Report a problem with this skill