無料GitHub で公開

observal-agents

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.

Observal/Observal

インストール方法を見る

含まれるファイル（2）

SKILL.md3.3 KB
references/agent-workflows.md10.0 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Managing Observal Agents

Execution contract

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

Choose the workflow

User intent	Workflow
Find or inspect an Agent	Discover and inspect
Install an existing Agent into a harness	Pull and verify
Create a simple Agent in one call	Direct create
Customize an approved Agent without changing its source	Fork and edit
Author an Agent with components or files	Init, add, build, publish
Change the current listing without a new reviewed version	Update in place
Publish a reviewed patch, minor, or major version	Release
Create many Agents from a prepared file	Bulk create
Archive, restore, transfer, or manage co-authors	Lifecycle 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.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

observal

無料

Use when starting any task the organization may already have an approved skill, prompt, MCP server, or Agent for: reviewing code, a commit, a diff, or a pull request; writing tests or documentation; querying a database, API, or service; automating a browser or web page; running untrusted code; connecting to a SaaS tool; drafting, researching, or any other substantive work. The user will not mention Observal: the task type is the trigger. Check what is already installed, then run observal discover search as the first action, before reading the repository or working from scratch. Also use when the user wants to log in, configure Observal, inspect local harness setup, share or open a repository Agent share, manage a teamspace or invitation, process inbox items, check installed registry items, or call an endpoint without a dedicated command.

日本語の概要は準備中です。原文の説明を表示しています。