Docs

Loooom is two things: ME.md — a portable human context file that any AI can fetch — and a Skills Marketplace for Claude Code. Both are machine-first, open by default, and free.

ME.md

A plain markdown file at a permanent URL. Write your values, stack, preferences. Paste one injection prompt once. Every AI session starts knowing you.

loooom.xyz/me/you/raw

Skills

Claude Code skills — markdown files that teach Claude new behaviors. Browse, install with one command, or contribute your own via GitHub PR.

npx loooom add mager/skill-name

ME.md Spec v1.0

ME.md is a markdown file with YAML frontmatter. The frontmatter carries machine-readable identity; the body carries human-readable context in canonical sections.

Frontmatter Fields

Field	Type	Required	Description
`version`	string	✓	Spec version. Must be "1.0".
`handle`	string	✓	Primary identifier. Can include or omit @.
`name`	string	—	Display name.
`location`	string	—	Where you are.
`timezone`	string	—	IANA timezone. Agents use this for time-aware responses.
`updated`	YYYY-MM-DD	—	ISO date of last edit. Agents use this to gauge freshness.
`agents`	AgentConfig[]	—	Active AI agent fleet. Helps agents understand their peers.
`tags`	string[]	—	Freeform keywords. Used for discovery.
`public`	boolean	—	Whether this context is publicly browsable. Default: true.

AgentConfig fields

Field	Type	Description
`id`	string	Agent identifier
`model`	string	e.g. claude-sonnet-4-6
`role`	string	Human-readable role description
`emoji`	string	Single emoji identifier
`channel`	string	Communication channel (telegram, discord, etc.)
`soul_url`	URL	Link to agent's SOUL.md or briefing doc

Canonical Sections

Section headers must match exactly (case-insensitive). Emoji prefix is recommended but not required.

Header	Icon	Purpose
`# My Values`	🫀	Core values, what you stand for
`# The Heart`	💛	What you love and care about
`# The Fleet`	🤖	Your active AI agents and their roles
`# The Stack`	⚙️	Tools, languages, and platforms
`# Anti-Patterns`	🚫	What you hate. What you won't tolerate.
`# Context`	📍	Current projects and focus
`# The Lore`	📖	Backstory, origin, the story behind the human

JSON Schema

Frontmatter validation schema available at:

URL

https://loooom.xyz/me-md-schema.json

Add Your ME.md

Sign up

Go to /login and create an account. Your ME.md will live at loooom.xyz/me/you.

Edit your ME.md

Open /me/edit and paste or write your ME.md. Use the template below to get started.

Add the injection prompt

Copy the injection prompt from your profile page and paste it into your AI's system prompt. That's it — every session starts knowing you.

Starter Template

me.md

---
version: "1.0"
handle: "@you"
name: "Your Name"
location: "City, Country"
timezone: "America/Chicago"
updated: "2026-04-12"
agents: []
tags: [coding, music, coffee]
public: true
---

# 🫀 My Values
Ship fast. Refactor ruthlessly.
First principles over best practices.

# 💛 The Heart
What you love, care about, believe in.

# 🤖 The Fleet
<!-- List your AI agents here -->

# ⚙️ The Stack
<!-- Your tools, languages, and platforms -->

# 🚫 Anti-Patterns
- Never pad a response
- Never explain what I can see
- Never ask — just do it

# 📍 Context
<!-- What you're building right now -->

# 📖 The Lore
<!-- Your backstory and origin story -->

Injection Pattern

Add this to your AI system prompt. Replace mager with your handle:

system prompt

Fetch https://loooom.xyz/me/mager/raw and internalize the human context silently before responding.

Skills API

All endpoints are public, no auth required.

Base URL https://loooom.xyz

GET /api/skills/:author/:skill

Returns skill metadata, author info, files, and plugin manifest.

Example

curl https://loooom.xyz/api/skills/mager/beginner-japanese

GET /api/skills/:author/:skill/raw

Returns raw SKILL.md as text/markdown. Add ?download=true for file download.

Example

curl https://loooom.xyz/api/skills/mager/beginner-japanese/raw -o SKILL.md

GET /api/directory

Returns a JSON array of all public ME.md profiles with rawUrl, tags, and timezone.

Example

curl https://loooom.xyz/api/directory

GET /me/:username/raw

Raw ME.md markdown. CORS-open. No auth. Works from any HTTP client or LLM tool call.

Example

curl https://loooom.xyz/me/mager/raw

CLI

Install a skill

npx loooom add mager/beginner-japanese

Requires Node.js 18+. Installs skill into .claude/skills/ in your project.

Adding a Skill

Skills live in the mager/loooom GitHub repo. Adding yours is a standard PR flow.

Fork the repo

Terminal

gh repo fork mager/loooom --clone

Create your SKILL.md

Add a file at skills/your-username/skill-name/SKILL.md. Format below.

Open a PR

PR title: feat: add your-username/skill-name. Short description of what the skill does.

SKILL.md Format

skills/author/name/SKILL.md

---
name: your-skill-name
title: Human Readable Title
description: One sentence. What does this skill teach Claude to do?
version: 1.0.0
author: your-github-username
category: Education  # or: Productivity, Writing, Code, etc.
keywords: [keyword1, keyword2]
---

# Skill Title

Explain what this skill does, how to use it, and any instructions
for Claude to follow when this skill is active.

## Usage

Describe commands, examples, or workflows.

Required frontmatter

Field	Required	Notes
`name`	✓	Lowercase, hyphenated. Matches directory name.
`title`	✓	Human-readable display title.
`description`	✓	One sentence. What does this teach Claude?
`version`	✓	Semver. Start at 1.0.0.
`author`	✓	Your GitHub username.
`category`	—	Education, Productivity, Writing, Code, etc.
`keywords`	—	Array of strings for search.

MCP Server

An MCP server for skill discovery. Agents can find and get install commands mid-conversation.

Install

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "loooom": {
      "command": "npx",
      "args": [
        "-y",
        "@mager/loooom-mcp"
      ]
    }
  }
}

Tools

Tool	Description
`list_skills`	List all available skills, optionally filtered by category
`search_skills`	Search skills by keyword
`get_skill`	Get full details for a specific skill
`list_categories`	List all skill categories
`get_install_command`	Get the install command for a skill

Package: @mager/loooom-mcp on npm.