Agent skill

Tlon

by tloncorp in tloncorp/tlon-apps

Read Tlon activity and message history; manage workspaces (Tlon groups), channels, Markdown notes, shared Bucket files, contacts, profiles, settings, and channel hooks; expose content publicly…

MITAuto-check passedKnowledge Management

Install Tlon

skills CLI
$ npx skills add tloncorp/tlon-apps --skill tlon -a claude-code

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

GitHub CLI
$ gh skill install tloncorp/tlon-apps tlon --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/tloncorp/tlon-apps.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/tlon-skill .claude/skills/tlon && 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
tlon
GitHub stars
107
Token cost
~1.1k tokens
SKILL.md length
558 words
Files
135 (incl. scripts, references)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Read Tlon activity and message history; manage workspaces (Tlon groups), channels, Markdown notes, shared Bucket files, contacts, profiles, settings, and channel hooks; expose content publicly…

  • Not general product explanations
  • SKILL.md covers Invoke and discover, Choose the task reference, Identity, delivery, and… and When discovery fails
  • Runs JavaScript scripts from its folder
  • Ordinary outbound messaging

What it does

Tlon is an agent skill from tloncorp/tlon-apps. Read Tlon activity and message history; manage workspaces (Tlon groups), channels, Markdown notes, shared Bucket files, contacts, profiles, settings, and channel hooks; expose content publicly; share hosted-browser sessions and arrange secure form handoffs. Use for operating Tlon, not general product explanations or ordinary outbound messaging.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 140 other files, including scripts and reference files (for example `EXPANSION_PLAN.md`, `MONOREPO_PROPOSAL.md` and `README.md`).

It sits in Knowledge Management, covering Note-taking. The repository describes itself as: Native, web clients, and server for Tlon Messenger. The licence is MIT.

When your agent uses it

  • Not general product explanations
  • Ordinary outbound messaging

Example prompts

  • “/tlon”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 61e412a. 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 1 file in scripts/ (JavaScript, from the files we listed), which the agent can run.

    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.

Context cost

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

Always · name and description, kept in context so the agent knows when to use it
~88
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
~10k

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 tloncorp/tlon-apps at commit 61e412a, republished under its MIT licence (© tloncorp). 558 words, ~1,114 tokens.

Download SKILL.mdSave it as .claude/skills/tlon/SKILL.md (or your agent's skills folder). This skill also uses 134 other files; get the full folder from GitHub.
name
tlon
description
Read Tlon activity and message history; manage workspaces (Tlon groups), channels, Markdown notes, shared Bucket files, contacts, profiles, settings, and channel hooks; expose content publicly; share hosted-browser sessions and arrange secure form handoffs. Use for operating Tlon, not general product explanations or ordinary outbound messaging.

Operate Tlon

Use the tlon tool for Tlon data and administration. Read the task reference below before an unfamiliar workflow. For explanations of the app, use tlon-product-guide if available.

In Tlon requests, workspace means a group: create, join, rename, invite, and list workspaces using groups commands. Explicit requests about the agent’s files or paths refer to its filesystem workspace instead.

Invoke and discover

Tool arguments are argument strings, not shell scripts:

json
{"command":"help"}
{"command":"help notes"}
{"command":"help notes note-create"}

--help and -h also work. This help covers only commands in the Tlon index; other tools such as message, read, and write have their own tool schemas, not Tlon subcommands. Exact flags live in command help; inspect it instead of guessing a verb or copying flags from a different operation. If CLI usage shows tlon at the start, omit it in the tool's command argument.

There is no shell expansion, pipe, redirection, or stdin transport. Use write to create a content file and pass its filename. Relative paths resolve in the active agent workspace, just like read and write. Do not put $VARIABLE, a heredoc, or inline Markdown in a filename argument.

Choose the task reference

Resolve these links relative to this skill's discovered directory. Use the location in the available-skills listing; do not assume a particular installation path. Read only the reference needed for the task.

TaskReference
Read activity, search history, manage reactions or existing postsReading
Workspaces (groups), membership, permissions, channels, public exposureGroups and channels
Find notebooks and create/edit Markdown notesNotes
Shared group files and foldersBuckets
Upload media for messages or profilesMedia
Contacts, profile changes, bot settingsContacts and settings
Share a hosted browser or have the owner enter credentials, address, or card detailsBrowser sharing and handoff
Channel hooks and advanced automationHooks
Show full SKILL.md (266 more words)Show less

Identity, delivery, and completion

  • Use returned group flags, channel nests, note IDs, and revisions. Display titles are not identifiers. Resolve ambiguous targets before writing.
  • Credentials are supplied by the runtime. Use the current account; do not collect access codes, print credentials, or switch to the owner's identity to work around permissions. Some documented commands, such as invite-link retrieval, have an explicit owner-bound behavior.
  • Use message for ordinary outbound messages and replies. For local media, upload first and pass the returned HTTPS URL; see the media reference.
  • Use groups create-owned to create a group for a user and make them an admin. Read the groups reference for the identity requirements.
  • Use notes for Markdown notebooks. Deprecated %diary management is unavailable through this tool; ask the owner to use /migrate <diary-nest> instead of attempting migration writes yourself.
  • Do not use LaTeX delimiters in note bodies or messages; use plain text/Unicode or code blocks.
  • Report a concrete failure if the task could not be completed. Verify the requested state before claiming success. A pending or host-confirmed write needs status/readback, not an immediate duplicate write.

When discovery fails

If this skill or a linked reference is unavailable, help and command help still provide local syntax. Report a missing installation resource rather than inventing a path. A permission failure or unsupported command is not a reason to bypass the tool through a shell, raw API, or the hosted browser. If neither tlon nor message covers the request, tell the user your Tlon tools do not support it yet and, where the Tlon app offers it, that they can do it there.

© tloncorp, 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 134 other files (scripts, references) in packages/tlon-skill of tloncorp/tlon-apps.

  • SKILL.md
  • .gitignore
  • .npmignore
  • EXPANSION_PLAN.md
  • MONOREPO_PROPOSAL.md
  • README.md
  • bin/tlon.js
  • bunfig.toml
  • npm/darwin-arm64/package.json
  • npm/darwin-x64/package.json
  • npm/linux-arm64/package.json
  • npm/linux-x64/package.json
  • operator-guide.md
  • package.json
  • references
  • … and 120 more

Open the folder on GitHubat commit 61e412a

Compare with similar skills

Tlon 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.

Tlon compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tlon this skilltloncorp/tlon-apps107—~1.1kAutomated safety check: PassMIT
Qmdalsk1992/CloddsBot2.9k3 repos~1.2kAutomated safety check: PassMIT
Obsidian Canvas BoardsAgriciDaniel/claude-obsidian15k—~1.4kAutomated safety check: PassMIT
LLM Wikilewislulu/llm-wiki-skill655—~3.7kAutomated safety check: PassNone
Para Memory Filespaperclipai/paperclip99k1 repos~909Automated safety check: PassMIT
Add Frontmatterheyitsnoah/claudesidian2.6k—~951Automated safety check: PassMIT

Similar skills

  • Qmd

    alsk1992/CloddsBot

    Local hybrid search for markdown notes and docs. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub starsUsed in 3 repos~1.2k tokens
    Knowledge ManagementAuto-check passed
  • Obsidian Canvas Boards

    AgriciDaniel/claude-obsidian

    Creates, inspects and updates Obsidian JSON Canvas boards in a vault, with text, file, link, group and edge nodes, using safe recoverable edits.

    15k GitHub stars~1.4k tokensUpdated 29 days ago
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    lewislulu/llm-wiki-skill

    Build and maintain a Karpathy-style LLM knowledge base — a self-compiling Obsidian markdown wiki where an Agent ingests raw sources, compiles cross-linked concept/entity/summary pages, answers…

    655 GitHub stars~3.7k tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • Para Memory Files

    paperclipai/paperclip

    Use a file-based PARA memory system to store, retrieve, and organize durable knowledge across sessions.

    99k GitHub starsUsed in 1 repo~909 tokens
    Knowledge ManagementAuto-check passed
  • Add Frontmatter

    heyitsnoah/claudesidian

    Add or update YAML frontmatter properties to enhance Obsidian note organization.

    2.6k GitHub stars~951 tokensUpdated 6 mo ago
    Knowledge ManagementAuto-check passed
  • Obsidian Bases Editor

    AgriciDaniel/claude-obsidian

    Explains, drafts and validates Obsidian Bases .base files, building filters, formulas and table, card or list views, and applying edits only through one inspected transaction.

    15k GitHub stars~1.2k tokensUpdated 29 days ago
    Knowledge ManagementAuto-check passed

More from tloncorp/tlon-apps

  • Mobile QA

    tloncorp/tlon-apps

    Run a mobile QA checklist on a physical Android device over adb for tlon-apps, then triage what fails into fixes.

    107 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Tlon Workflow

    tloncorp/tlon-apps

    A skill your agent uses when taking a Tlon Messenger task from a fresh worktree to a merged pull request: reproducing or fixing something in the iOS, Android or web app, validating it on a…

    107 GitHub stars~8.9k tokensUpdated today
    Auto-check: notes
  • Tlon Workflow Doctor

    tloncorp/tlon-apps

    A skill your agent uses when setting up a machine for mobile agent work on this repository, when the tlon-workflow skill's prerequisite check fails, or when stim, agent-device, eas-cli, gh, or their…

    107 GitHub stars~1.2k tokensUpdated today
    Auto-check: notes
  • Verify

    tloncorp/tlon-apps

    Verify tlon-apps web UI changes end-to-end with a single local ship + vite dev server (lighter than the full playwright-dev rig)

    107 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Tlon Product Guide

    tloncorp/tlon-apps

    Answer questions about Tlon, Urbit, Tlon Messenger, Tlonbot, and OpenClaw — what they are, how they work, and how to use them.

    107 GitHub stars~11k tokensUpdated today
    Auto-check passed

Questions about Tlon

What does Tlon do?

Read Tlon activity and message history; manage workspaces (Tlon groups), channels, Markdown notes, shared Bucket files, contacts, profiles, settings, and channel hooks; expose content publicly…. Tlon is an agent skill from tloncorp/tlon-apps. Read Tlon activity and message history; manage workspaces (Tlon groups), channels, Markdown notes, shared Bucket files, contacts, profiles, settings, and channel hooks; expose content publicly; share hosted-browser sessions and arrange secure form handoffs.

When should I use Tlon?

Tlon fits situations like: not general product explanations; ordinary outbound messaging.

How do I install Tlon in Claude Code?

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

How do I install Tlon in Codex?

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

Can I use Tlon 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 tloncorp/tlon-apps --skill tlon -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tlon, .gemini/skills/tlon, .github/skills/tlon and .opencode/skills/tlon in your project.

What does Tlon need to run?

Going by SKILL.md and its folder, Tlon needs JavaScript for the scripts in its folder. Our summary lists: Node.js.

Does Tlon 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 Tlon 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 Tlon use?

Tlon 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 Tlon 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 9.4k tokens, read only when the agent opens those files.

What are the alternatives to Tlon?

Skills that share tags, products or a category with Tlon: Qmd (alsk1992/CloddsBot, 2.9k stars), Obsidian Canvas Boards (AgriciDaniel/claude-obsidian, 15k stars), LLM Wiki (lewislulu/llm-wiki-skill, 655 stars) and Para Memory Files (paperclipai/paperclip, 99k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tlon?

tloncorp (a GitHub organization) maintains it in tloncorp/tlon-apps, which has 107 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 9, 2026.

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