Agent skill

Beam

by openclaw in openclaw/agent-skills

Publish a redacted local coding session to an authenticated read-only Beam catalog.

MITAuto-check passed

Install Beam

skills CLI
$ npx skills add openclaw/agent-skills --skill beam -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install openclaw/agent-skills beam --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/openclaw/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/beam .claude/skills/beam && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
beam
GitHub stars
1.1k
Token cost
~1.1k tokens
SKILL.md length
428 words
Files
8 (incl. scripts, references)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Publish a redacted local coding session to an authenticated read-only Beam catalog.

  • SKILL.md covers Contract, Snapshot, Live Hooks and Development
  • Runs JavaScript scripts from its folder; calls node and cloudflared; needs BEAM_ACCESS_TOKEN and BEAM_AUTH_TOKEN

What it does

Beam is an agent skill from openclaw/agent-skills. Publish a redacted local coding session to an authenticated read-only Beam catalog.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `README.md`, `package.json` and `references/claude-code-hooks.json`).

The repository describes itself as: Useful skills for agents and claws. The licence is MIT.

Example prompts

  • “/beam”

Requirements

  • Node.js
  • A credential in BEAM_ACCESS_TOKEN
  • A credential in BEAM_AUTH_TOKEN

What it can do on your machine

Read from SKILL.md and the folder at commit 7e73306. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • cloudflared

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • BEAM_ACCESS_TOKEN
    • BEAM_AUTH_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Beam loads about 1.1k tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 22 tokens; SKILL.md has 428 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from openclaw/agent-skills at commit 7e73306, republished under its MIT licence (© openclaw). 428 words, ~1,130 tokens.

Download SKILL.mdSave it as .claude/skills/beam/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
beam
description
Publish a redacted local coding session to an authenticated read-only Beam catalog.

Beam

Use when the user explicitly asks to beam, publish, or share the current local coding session with an authenticated OpenClaw receiver.

Contract

  • Treat invoking this skill as approval for one snapshot upload to the named destination.
  • Never upload raw JSONL, reasoning, system/developer prompts, tool output, environment values, credentials, browser state, cookies, or local paths.
  • The helper is self-contained: it resolves and parses exact Claude Code or Codex transcripts, then uploads only locally redacted user/assistant messages and compact tool counts.
  • Beam is a read-only projection. Do not connect a node, expose a terminal, resume the local harness remotely, or grant the receiver filesystem/tool access.
  • Require HTTPS except for loopback development endpoints.
  • Authenticate with BEAM_ACCESS_TOKEN, BEAM_AUTH_TOKEN, or an interactive cloudflared access login. Never print those values.
  • Live synchronization is opt-in persistent behavior. Do not install hooks unless the user explicitly asks for live Beam updates.

Snapshot

Set or obtain the destination receiver URL first:

bash
export BEAM_ENDPOINT="https://example.internal/api/v1/beam/sessions"

Prefer the harness-specific exact identifier. Resolve the directory containing this SKILL.md as BEAM_SKILL_DIR first.

Claude Code exposes the current session id:

bash
node "$BEAM_SKILL_DIR/scripts/beam" publish \
  --endpoint "$BEAM_ENDPOINT" \
  --session-id "${CLAUDE_SESSION_ID}"

In Codex, resolve the directory containing this SKILL.md as BEAM_SKILL_DIR; normal shell-tool children expose the current thread id:

bash
node "$BEAM_SKILL_DIR/scripts/beam" publish \
  --endpoint "$BEAM_ENDPOINT" \
  --thread-id "$CODEX_THREAD_ID"

Prefer exact harness metadata when available:

  • Claude Code: ${CLAUDE_SESSION_ID} identifies the current local conversation; the helper finds its transcript.
  • Codex shell tools: CODEX_THREAD_ID identifies the current thread.
  • Hook adapters: pass their JSON to beam hook; transcript_path is authoritative.
  • Exact fallback: Beam scans only the native Claude/Codex session roots for the supplied id and fails closed on no match or ambiguity.

Useful options:

bash
node "$BEAM_SKILL_DIR/scripts/beam" publish --endpoint "$BEAM_ENDPOINT" --session /path/to/session.jsonl
node "$BEAM_SKILL_DIR/scripts/beam" publish --endpoint "$BEAM_ENDPOINT" --thread-id "$CODEX_THREAD_ID"
node "$BEAM_SKILL_DIR/scripts/beam" publish --endpoint "$BEAM_ENDPOINT" --title "Fix upload flow"
node "$BEAM_SKILL_DIR/scripts/beam" publish --endpoint "$BEAM_ENDPOINT" --complete
node "$BEAM_SKILL_DIR/scripts/beam" publish --endpoint "$BEAM_ENDPOINT" --dry-run

--dry-run prints the sanitized payload locally and performs no network request.

Show full SKILL.md (163 more words)Show less

On success, return only the Beam URL and a short disclosure summary: source harness, shared message count, whether older entries were truncated, and whether the beam is complete. The URL uses the endpoint-derived Control UI base path followed by /beam/<title-slug>-<id-prefix>, for example https://gateway.example.com/beam/fix-upload-flow-0123456789ab. The title comes from --title or the first shared user message. The stable ID suffix identifies the session; links with an earlier title remain valid.

The helper also accepts bare /beam/<id-prefix> links and, during rollout, the current server's exact /chat/<agent>?catalog=beam&host=gateway&thread=<full-beam-id> response. It still rejects the obsolete ?session=catalog:... beta form.

Live Hooks

The helper accepts the snake_case JSON emitted by both Claude Code and Codex lifecycle hooks:

bash
node "$BEAM_SKILL_DIR/scripts/beam" hook --endpoint "$BEAM_ENDPOINT" --quiet

Configure root Stop hooks for turn-by-turn updates. Claude Code can also use SessionEnd for finalization; Codex finalization uses an explicit publish --complete. See:

  • references/claude-code-hooks.json
  • references/codex-hooks.toml

Hook failures must not block the coding session. Keep them quiet on success; log one concise redacted error on failure.

Full installation, authentication, data-boundary, and hook documentation: README.md.

Development

bash
node --check skills/beam/scripts/beam
node --check skills/beam/scripts/beam-session.js
node --test skills/beam/scripts/beam.test.mjs
scripts/validate-skills

© openclaw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts, references) in skills/beam of openclaw/agent-skills.

  • SKILL.md
  • README.md
  • package.json
  • references/claude-code-hooks.json
  • references/codex-hooks.toml
  • scripts/beam
  • scripts/beam-session.js
  • scripts/beam.test.mjs

Open the folder on GitHubat commit 7e73306

Compare with similar skills

Beam next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Beam compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Beam this skillopenclaw/agent-skills1.1k—~1.1kAutomated safety check: PassMIT
Publishcode-yeongyu/oh-my-openagent70k—~5.5kAutomated safety check: WarnCustom licence
Agent Authenticationruvnet/ruflo74k3 repos~711Automated safety check: PassMIT
Social Publisheraffaan-m/ECC274k1 repos~1.1kAutomated safety check: PassMIT
Publishyc-software/qm15k—~2.2kAutomated safety check: WarnMIT
Social Publishingwshobson/agents40k—~914Automated safety check: PassMIT

Similar skills

  • Publish

    code-yeongyu/oh-my-openagent

    Publish oh-my-opencode to npm by triggering the GitHub Actions publish workflow and verifying its artifacts.

    70k GitHub stars~5.5k tokensUpdated today
    DevOps & CloudAuto-check: warnings
  • Agent skill for authentication - invoke with $agent-authentication

    74k GitHub starsUsed in 3 repos~711 tokens
    Backend & APIsAuto-check passed
  • Social Publisher

    affaan-m/ECC

    Agent-driven scheduling and publishing of social media posts across 13 platforms via SocialClaw.

    274k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Publish

    yc-software/qm

    Publish a long-lived internal web app, site, or dashboard from the agent computer.

    15k GitHub stars~2.2k tokensUpdated today
    DevOps & CloudAuto-check: warnings
  • Social Publishing

    wshobson/agents

    Schedule and publish social media posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via the SocialClaw API.

    40k GitHub stars~914 tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Publish

    Q00/ouroboros

    Publish Seed specification as GitHub Issues for team-based project management

    6.2k GitHub stars~2.7k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from openclaw/agent-skills

  • Session Viewer

    openclaw/agent-skills

    Render Codex, Claude Code, OpenClaw, or Pi session JSONL transcripts as a searchable, shareable single-file HTML viewer.

    1.1k GitHub stars~918 tokensUpdated today
    Auto-check passed
  • Team Handoff

    openclaw/agent-skills

    Hand local work to a shared OpenClaw Gateway: start a worktree session there as yourself in one request, seeded with a handoff, and get the session URL back.

    1.1k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Behavior Validator

    openclaw/agent-skills

    Source-blind user behavior validation against a prewritten contract for apps, CLIs, APIs, and generated artifacts.

    1.1k GitHub stars~940 tokensUpdated today
    Auto-check passed
  • Crabbox Remote Test Runner

    openclaw/agent-skills

    Detects the Crabbox CLI or config in a repository and uses it to run tests and validation on remote runners, with checks before touching secrets or paid infrastructure.

    1.1k GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Handoff

    openclaw/agent-skills

    Clipboard-ready handoff prompt for another agent to investigate or continue a task.

    1.1k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Readme Standard

    openclaw/agent-skills

    House README standard: structure, badge row, tone, per-archetype templates, and verification gates for steipete/openclaw repos.

    1.1k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Questions about Beam

What does Beam do?

Publish a redacted local coding session to an authenticated read-only Beam catalog. Beam is an agent skill from openclaw/agent-skills. Publish a redacted local coding session to an authenticated read-only Beam catalog.

How do I install Beam in Claude Code?

Run `npx skills add openclaw/agent-skills --skill beam -a claude-code`. Or copy the skill folder (skills/beam in openclaw/agent-skills) into .claude/skills/beam in your project. Claude Code loads it when a task matches its description.

How do I install Beam in Codex?

Run `npx skills add openclaw/agent-skills --skill beam -a codex`. Or copy the skill folder (skills/beam in openclaw/agent-skills) into .agents/skills/beam in your project. Codex loads it when a task matches its description.

Can I use Beam in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openclaw/agent-skills --skill beam -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/beam, .gemini/skills/beam, .github/skills/beam and .opencode/skills/beam in your project.

What does Beam need to run?

Going by SKILL.md and its folder, Beam needs JavaScript for the scripts in its folder, the command-line tools its instructions call (node and cloudflared) and credentials named BEAM_ACCESS_TOKEN and BEAM_AUTH_TOKEN. Our summary lists: Node.js; A credential in BEAM_ACCESS_TOKEN; A credential in BEAM_AUTH_TOKEN.

Does Beam access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Beam safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Beam use?

Beam is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Beam use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 210 tokens, read only when the agent opens those files.

What are the alternatives to Beam?

Skills that share tags, products or a category with Beam: Publish (code-yeongyu/oh-my-openagent, 70k stars), Agent Authentication (ruvnet/ruflo, 74k stars), Social Publisher (affaan-m/ECC, 274k stars) and Publish (yc-software/qm, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Beam?

openclaw (a GitHub organization) maintains it in openclaw/agent-skills, which has 1,102 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

Source: openclaw/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.