New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Beacon Memory Promote

by Asymptote-Labs in Asymptote-Labs/agent-beacon

Install approved Beacon project memory as an Agent Skill in the repository (.agents/skills/<slug/SKILL.md), so every skill-capable harness loads the lesson automatically without a memory lookup.

MITAuto-check passedAgent Workflows

Install Beacon Memory Promote

skills CLI
$ npx skills add Asymptote-Labs/agent-beacon --skill beacon-memory-promote -a claude-code

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

GitHub CLI
$ gh skill install Asymptote-Labs/agent-beacon beacon-memory-promote --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/Asymptote-Labs/agent-beacon.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent-skills/skills/beacon-memory-promote .claude/skills/beacon-memory-promote && 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
beacon-memory-promote
GitHub stars
1.8k
Token cost
~927 tokens
SKILL.md length
417 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Install approved Beacon project memory as an Agent Skill in the repository (.agents/skills/<slug/SKILL.md), so every skill-capable harness loads the lesson automatically without a memory lookup.

  • Works in 4 steps: choose the memory → preview → install, after the user confirms → …
  • The user asks to make this a skill
  • SKILL.md covers What to promote, Step 1: choose the memory, Step 2: preview and Step 3: install, after the…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Beacon Memory Promote is an agent skill from Asymptote-Labs/agent-beacon. Install approved Beacon project memory as an Agent Skill in the repository (.agents/skills/<slug/SKILL.md), so every skill-capable harness loads the lesson automatically without a memory lookup. Use when the user asks to "make this a skill", "promote", "install", or "share" an approved Beacon memory, or wants the team's agents to always follow a learned workflow or convention.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires the Beacon CLI (beacon) on PATH. Local only. Writes files inside the current project.

It sits in Agent Workflows, covering Agent memory. The repository describes itself as: The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu. The licence is MIT.

When your agent uses it

  • The user asks to make this a skill
  • Share an approved Beacon memory
  • Wants the teams agents to always follow a learned workflow

Example prompts

  • “make this a skill”
  • “promote”
  • “install”
  • “/beacon-memory-promote”

Requirements

  • Compatibility (from SKILL.md): Requires the Beacon CLI (beacon) on PATH. Local only. Writes files inside the current project.

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. choose the memory
  2. preview
  3. install, after the user confirms
  4. hand off

What it can do on your machine

Read from SKILL.md and the folder at commit 2462839. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    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 no API keys, tokens, secrets or passwords.

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

  • Compatibility

    Requires the Beacon CLI (beacon) on PATH. Local only. Writes files inside the current project.

    From compatibility in the SKILL.md frontmatter.

Context cost

Beacon Memory Promote loads about 927 tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 417 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~101
When it runs · the whole SKILL.md, loaded when a task matches
~927

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Asymptote-Labs/agent-beacon at commit 2462839, republished under its MIT licence (© Asymptote-Labs). 417 words, ~927 tokens.

Download SKILL.mdSave it as .claude/skills/beacon-memory-promote/SKILL.md (or your agent's skills folder).
name
beacon-memory-promote
description
Install approved Beacon project memory as an Agent Skill in the repository (.agents/skills/<slug>/SKILL.md), so every skill-capable harness loads the lesson automatically without a memory lookup. Use when the user asks to "make this a skill", "promote", "install", or "share" an approved Beacon memory, or wants the team's agents to always follow a learned workflow or convention.
compatibility
Requires the Beacon CLI (beacon) on PATH. Local only. Writes files inside the current project.
license
MIT
metadata.author
asymptote-labs
metadata.homepage
https://docs.beacon.sh/cli/memory
metadata.version
0.1.0

Beacon memory promote: memory to skill

Approved memory is recalled on demand. A skill is loaded by the harness itself whenever its description matches the task, and when it is committed to the repository it reaches every teammate and every harness that reads .agents/skills (Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Amp, goose, and others; Claude Code reads .claude/skills).

Promote only what earns that. Each installed skill adds to what every agent considers on every task.

What to promote

Good candidates:

  • workflow and convention memories that apply to many tasks in this repository.
  • A debugging_pattern for a failure that keeps recurring.

Leave in memory, where recall finds them when needed:

  • One-off gotchas tied to a single file or incident.
  • Anything that duplicates the repository's CLAUDE.md, AGENTS.md, or contributing docs. Suggest editing those docs instead.

Step 1: choose the memory

bash
beacon memory list --limit 25
beacon memory show <memory-id> --json

The skill commands take the candidate ID, which is the candidate_id field of the memory.

Step 2: preview

bash
beacon memory skills preview <candidate-id>

Check the preview with the user:

  • The description is the title plus the memory's applicability. It decides when a harness loads the skill, so it must name the trigger (a command, path, or error). If it is vague, the fix is a better memory: draft a sharper title and applicability, approve a replacement through the beacon-memory-distill workflow, and supersede the old one.
  • The body must hold no secrets, hostnames, or personal details. It is about to become a file that is likely to be committed.
Show full SKILL.md (175 more words)Show less

Step 3: install, after the user confirms

bash
beacon memory skills install <candidate-id>

This writes .agents/skills/<slug>/SKILL.md in the project (or the --project path). It refuses to overwrite an existing file; pass --force only when the user wants to replace the generated skill, and never over a file a person has edited by hand without asking.

For Claude Code, which reads .claude/skills rather than .agents/skills, offer to link the skill there:

bash
mkdir -p .claude/skills && ln -s ../../.agents/skills/<slug> .claude/skills/<slug>

Step 4: hand off

Show the path and remind the user that:

  • The file carries Beacon provenance under metadata (beacon_memory_id, beacon_candidate_id), so a reviewer can trace it back to the approved memory and the source session.
  • It becomes team-wide only when they commit it. Do not commit or push unless they ask.
  • If the memory is later superseded, the installed skill is not updated automatically. Re-run preview and install with --force from the replacement candidate.

Boundaries

  • Never install without the user seeing the preview and confirming.
  • Never approve or edit memory here. Use beacon-memory-distill.
  • Do not write to user-level skill directories (such as ~/.agents/skills). Beacon memory is scoped to a project.

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

Files

Just SKILL.md in agent-skills/skills/beacon-memory-promote of Asymptote-Labs/agent-beacon.

Open the folder on GitHubat commit 2462839

Compare with similar skills

Beacon Memory Promote 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.

Beacon Memory Promote compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Beacon Memory Promote this skillAsymptote-Labs/agent-beacon1.8k—~927Automated safety check: PassMIT
Reflect on Session Learningscursor/plugins11k5 repos~1.2kAutomated safety check: PassNone
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Beads Task Memorygastownhall/beads28k—~1.2kAutomated safety check: PassMIT
MemPalace Memory SearchMemPalace/mempalace60k—~1.4kAutomated safety check: PassMIT
Compound Learning WriterEveryInc/compound-engineering-plugin25k—~2kAutomated safety check: PassMIT

Similar skills

  • Reflect on Session Learnings

    cursor/plugins

    Official

    Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.

    11k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed

  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • MemPalace Memory Search

    MemPalace/mempalace

    Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.

    60k GitHub stars~1.4k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Compound Learning Writer

    EveryInc/compound-engineering-plugin

    Records one solved and verified problem as a durable learning in the repository, but only when the reasoning is not already clear from the final code, tests or docs.

    25k GitHub stars~2k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Session History Search

    slopus/happy

    Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from Asymptote-Labs/agent-beacon

  • Beacon Memory Distill

    Asymptote-Labs/agent-beacon

    Turn recorded agent sessions (Beacon traces from Claude Code, Cursor, Codex, OpenCode, and other harnesses) into reviewed, reusable project memory.

    1.8k GitHub stars~3k tokensUpdated today
    Auto-check passed

  • Beacon Lens Create

    Asymptote-Labs/agent-beacon

    Create, revise, debug or validate a Beacon lens, a single HTML file that renders one agent trace as a purpose-built view (a per-file review, a cost breakdown, a timeline of risky commands, a map of…

    1.8k GitHub stars~3.3k tokensUpdated today
    Auto-check passed

  • Beacon Memory Recall

    Asymptote-Labs/agent-beacon

    Retrieve reviewed project memory that Beacon distilled from earlier agent sessions in any harness (Claude Code, Cursor, Codex, OpenCode, and others) before starting work.

    1.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

  • Self Verify Beacon In Sandbox

    Asymptote-Labs/agent-beacon

    Verify a Beacon change end to end by running a real Claude Code session inside a disposable Linux cloud sandbox and checking that Beacon captured what the agent actually did.

    1.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Beacon Memory Promote

What does Beacon Memory Promote do?

Install approved Beacon project memory as an Agent Skill in the repository (.agents/skills/<slug/SKILL.md), so every skill-capable harness loads the lesson automatically without a memory lookup. Beacon Memory Promote is an agent skill from Asymptote-Labs/agent-beacon.md), so every skill-capable harness loads the lesson automatically without a memory lookup.

When should I use Beacon Memory Promote?

Beacon Memory Promote fits situations like: the user asks to make this a skill; share an approved Beacon memory; wants the teams agents to always follow a learned workflow.

How do I install Beacon Memory Promote in Claude Code?

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

How do I install Beacon Memory Promote in Codex?

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

Can I use Beacon Memory Promote 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 Asymptote-Labs/agent-beacon --skill beacon-memory-promote -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/beacon-memory-promote, .gemini/skills/beacon-memory-promote, .github/skills/beacon-memory-promote and .opencode/skills/beacon-memory-promote in your project.

What does Beacon Memory Promote need to run?

SKILL.md names no scripts, command-line tools or credentials: Beacon Memory Promote is instructions for the agent only. Compatibility (from SKILL.md): Requires the Beacon CLI (beacon) on PATH. Local only. Writes files inside the current project..

Does Beacon Memory Promote 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 Beacon Memory Promote 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. Review the folder before installing.

What licence does Beacon Memory Promote use?

Beacon Memory Promote is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Beacon Memory Promote use?

About 927 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Beacon Memory Promote?

Skills that share tags, products or a category with Beacon Memory Promote: Reflect on Session Learnings (cursor/plugins, 11k stars), Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars), Beads Task Memory (gastownhall/beads, 28k stars) and MemPalace Memory Search (MemPalace/mempalace, 60k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Beacon Memory Promote?

Asymptote-Labs (a GitHub organization) maintains it in Asymptote-Labs/agent-beacon, which has 1,810 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 11, 2026.

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