Searchable Elixir/Phoenix/Ecto solution documentation system with YAML frontmatter.

MITAuto-check passedKnowledge Management

Install Compound Docs

skills CLI
$ npx skills add oliver-kriska/claude-elixir-phoenix --skill compound-docs -a claude-code

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

GitHub CLI
$ gh skill install oliver-kriska/claude-elixir-phoenix compound-docs --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/oliver-kriska/claude-elixir-phoenix.git skills-src && mkdir -p .claude/skills && cp -r skills-src/targets/pi/skills/compound-docs .claude/skills/compound-docs && 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
compound-docs
GitHub stars
565
Token cost
~547 tokens
SKILL.md length
121 words
Files
3 (incl. references)
Skills in repo
105
Repo updated
First seen
Licence
MIT

At a glance

Searchable Elixir/Phoenix/Ecto solution documentation system with YAML frontmatter.

  • Works in 4 steps: ALWAYS search solutions before… → YAML frontmatter is MANDATORY — Every… → One problem per file — Never combine… → …
  • Consulting past solutions before investigating new issues
  • SKILL.md covers Directory Structure, Iron Laws, Solution File Format and Searching Solutions, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Compound Docs is an agent skill from oliver-kriska/claude-elixir-phoenix. Searchable Elixir/Phoenix/Ecto solution documentation system with YAML frontmatter. Builds institutional knowledge from solved problems. Use when consulting past solutions before investigating new issues.

Its SKILL.md is about 550 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/resolution-template.md` and `references/schema.md`).

It sits in Knowledge Management, covering Knowledge bases and LLM observability. It works with Elixir. The repository describes itself as: Claude Code plugin for Elixir/Phoenix/LiveView — 26 specialist agents, Iron Laws enforcement, and Tidewave MCP integration. Plan features with parallel research agents, execute… The licence is MIT.

When your agent uses it

  • Consulting past solutions before investigating new issues
  • Tasks that involve Knowledge bases
  • Tasks that involve LLM observability

Example prompts

  • “/compound-docs”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. ALWAYS search solutions before investigating — Check
  2. YAML frontmatter is MANDATORY — Every solution needs
  3. One problem per file — Never combine multiple solutions
  4. Include prevention — Every solution documents how to

What it can do on your machine

Read from SKILL.md and the folder at commit 9767a82. 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 markdown).

    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

Compound Docs loads about 547 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 55 tokens; SKILL.md has 121 words of instructions outside code blocks.

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

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 oliver-kriska/claude-elixir-phoenix at commit 9767a82, republished under its MIT licence (© oliver-kriska). 121 words, ~547 tokens.

Download SKILL.mdSave it as .claude/skills/compound-docs/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
compound-docs
description
Searchable Elixir/Phoenix/Ecto solution documentation system with YAML frontmatter. Builds institutional knowledge from solved problems. Use when consulting past solutions before investigating new issues.

Compound Docs — Institutional Knowledge Base

Searchable, categorized solution documentation that makes each debugging session easier than the last.

Directory Structure

.claude/solutions/
├── ecto-issues/
├── liveview-issues/
├── oban-issues/
├── otp-issues/
├── security-issues/
├── testing-issues/
├── phoenix-issues/
├── deployment-issues/
├── performance-issues/
└── build-issues/

Iron Laws

  1. ALWAYS search solutions before investigating — Check .claude/solutions/ for existing fixes before debugging
  2. YAML frontmatter is MANDATORY — Every solution needs validated metadata per references/schema.md
  3. One problem per file — Never combine multiple solutions
  4. Include prevention — Every solution documents how to prevent recurrence

Solution File Format

markdown
---
module: "Accounts"
date: "2025-12-01"
problem_type: runtime_error
component: ecto_schema
symptoms:
  - "Ecto.Association.NotLoaded on user.posts"
root_cause: missing_preload
severity: medium
tags: [preload, association, n-plus-one]
---

# Association NotLoaded on User Posts

## Symptoms
Ecto.Association.NotLoaded raised when accessing user.posts
in UserListLive after filtering.

## Root Cause
Query in Accounts context missing preload for :posts.

## Solution
Added `Repo.preload(:posts)` to `list_users/1`.

## Prevention
Use n1-check skill before shipping list views.

Searching Solutions

Use Grep to search .claude/solutions/ by symptom (e.g., NotLoaded), by tag (e.g., tags:.*preload), or by component (e.g., component: ecto).

Integration

  • /skill:phx-compound creates solution docs here
  • /skill:phx-investigate searches here before debugging
  • /skill:phx-plan consults for known risks
  • learn-from-fix feeds into this system

References

  • references/schema.md — YAML frontmatter validation schema
  • references/resolution-template.md — Full solution template

© oliver-kriska, 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 2 other files (references) in targets/pi/skills/compound-docs of oliver-kriska/claude-elixir-phoenix.

  • SKILL.md
  • references/resolution-template.md
  • references/schema.md

Open the folder on GitHubat commit 9767a82

Compare with similar skills

Compound Docs 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.

Compound Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Compound Docs this skilloliver-kriska/claude-elixir-phoenix565—~547Automated safety check: PassMIT
Knowledgebaseopen-edge-platform/edge-ai-suites140—~900Automated safety check: PassApache-2.0
Work Operating ModelNateBJones-Projects/OB14.7k—~2.2kAutomated safety check: PassCustom licence
Openloomimelandlabs/openloomi1k—~835Automated safety check: PassApache-2.0
Firecrawl Knowledge Basefirecrawl/skills116—~612Automated safety check: PassISC
Knowledge Base For Startupsaws/agent-toolkit-for-aws2.8k—~2.9kAutomated safety check: PassApache-2.0

Similar skills

  • Knowledgebase

    open-edge-platform/edge-ai-suites

    Generic RAG query skill - Retrieve any information from the local knowledge base and generate structured reports, summaries, or Q&A responses.

    140 GitHub stars~900 tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Work Operating Model

    NateBJones-Projects/OB1

    Conversation-first workflow for turning tacit work patterns into a structured operating model.

    4.7k GitHub stars~2.2k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Openloomi

    melandlabs/openloomi

    OpenLoomi entrypoint for skill-only agent runtimes without a plugin mechanism.

    1k GitHub stars~835 tokensUpdated 15 days ago
    Knowledge ManagementAuto-check passed
  • Firecrawl Knowledge Base

    firecrawl/skills

    Build a knowledge base from web content with Firecrawl. An agent skill from firecrawl/skills.

    116 GitHub stars~612 tokensUpdated 2 days ago
    Knowledge ManagementAuto-check passed
  • Knowledge Base For Startups

    aws/agent-toolkit-for-aws

    Official

    AWS Startups reference content — Activate FAQ, credits guide, programs, partner offers, sample architectures, and hundreds of learn articles spanning generative AI, cloud architecture, cost…

    2.8k GitHub stars~2.9k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Clarity Gate

    majiayu000/claude-skill-registry

    Pre-ingestion verification for epistemic quality in RAG systems.

    666 GitHub starsUsed in 4 repos~6.2k tokens
    Knowledge ManagementAuto-check passed

More from oliver-kriska/claude-elixir-phoenix

All 105 skills in this repo
  • Phx Brief

    oliver-kriska/claude-elixir-phoenix

    Interactive briefing of a plan file — explains reasoning, schema decisions, component choices.

    565 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Codex Ab

    oliver-kriska/claude-elixir-phoenix

    Run an A/B codex review experiment — holistic codex review vs 3 focused dimension passes (security, ecto, liveview) on the branch diff, classify findings, report a panel-value verdict.

    565 GitHub stars~977 tokensUpdated 3 days ago
    Auto-check passed
  • Audit

    oliver-kriska/claude-elixir-phoenix

    Project health audit and health check — architecture, performance, tests, dependencies, code quality.

    565 GitHub stars~2k tokensUpdated 3 days ago
    Auto-check passed
  • Compound Docs

    oliver-kriska/claude-elixir-phoenix

    Searchable Elixir/Phoenix/Ecto solution documentation system with; Use when consulting past solutions…

    565 GitHub stars~528 tokensUpdated 3 days ago
    Auto-check passed
  • Deploy

    oliver-kriska/claude-elixir-phoenix

    Elixir/Phoenix deployment patterns — Dockerfile, fly.toml, runtime.exs, mix release, rel/ overlays.

    565 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Deps Update

    oliver-kriska/claude-elixir-phoenix

    Bump outdated Hex deps — inventory, snapshot changelogs, update, fix breaks, split reviewable PRs (patches bundled, majors solo).

    565 GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check passed

Works with

Questions about Compound Docs

What does Compound Docs do?

Searchable Elixir/Phoenix/Ecto solution documentation system with YAML frontmatter. Compound Docs is an agent skill from oliver-kriska/claude-elixir-phoenix. Searchable Elixir/Phoenix/Ecto solution documentation system with YAML frontmatter.

When should I use Compound Docs?

Compound Docs fits situations like: consulting past solutions before investigating new issues; tasks that involve Knowledge bases; tasks that involve LLM observability.

How do I install Compound Docs in Claude Code?

Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill compound-docs -a claude-code`. Or copy the skill folder (targets/pi/skills/compound-docs in oliver-kriska/claude-elixir-phoenix) into .claude/skills/compound-docs in your project. Claude Code loads it when a task matches its description.

How do I install Compound Docs in Codex?

Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill compound-docs -a codex`. Or copy the skill folder (targets/pi/skills/compound-docs in oliver-kriska/claude-elixir-phoenix) into .agents/skills/compound-docs in your project. Codex loads it when a task matches its description.

Can I use Compound Docs 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 oliver-kriska/claude-elixir-phoenix --skill compound-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/compound-docs, .gemini/skills/compound-docs, .github/skills/compound-docs and .opencode/skills/compound-docs in your project.

What does Compound Docs need to run?

SKILL.md names no scripts, command-line tools or credentials: Compound Docs is instructions for the agent only.

Does Compound Docs 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 Compound Docs 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 Compound Docs use?

Compound Docs 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 Compound Docs use?

About 547 tokens (SKILL.md is roughly 2.2k 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 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Compound Docs?

Skills that share tags, products or a category with Compound Docs: Knowledgebase (open-edge-platform/edge-ai-suites, 140 stars), Work Operating Model (NateBJones-Projects/OB1, 4.7k stars), Openloomi (melandlabs/openloomi, 1k stars) and Firecrawl Knowledge Base (firecrawl/skills, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Compound Docs?

oliver-kriska (a GitHub user) maintains it in oliver-kriska/claude-elixir-phoenix, which has 565 GitHub stars. The repository holds 105 skills in this directory. The repository was last updated on October 5, 2026.

Source: oliver-kriska/claude-elixir-phoenix on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.