Agent skill

RAG Assistant

by Atmosphere in Atmosphere/atmosphere

Knowledge base assistant that retrieves and cites documents from a curated index.

Apache-2.0Auto-check passedAI & LLM Engineering

Install RAG Assistant

skills CLI
$ npx skills add Atmosphere/atmosphere --skill rag-assistant -a claude-code

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

GitHub CLI
$ gh skill install Atmosphere/atmosphere rag-assistant --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/Atmosphere/atmosphere.git skills-src && mkdir -p .claude/skills && cp -r skills-src/modules/skills/src/main/resources/META-INF/skills/rag-assistant .claude/skills/rag-assistant && 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
rag-assistant
GitHub stars
3.8k
Token cost
~504 tokens
SKILL.md length
229 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
Apache-2.0

At a glance

Knowledge base assistant that retrieves and cites documents from a curated index.

  • Works in 5 steps: Search the knowledge base for relevant… → Read the most relevant documents carefully → Compose your answer using ONLY… → …
  • Answering questions that must be grounded in specific source material with citations
  • SKILL.md covers Skills, Tools and Guardrails
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

RAG Assistant is an agent skill from Atmosphere/atmosphere. Knowledge base assistant that retrieves and cites documents from a curated index. Use when answering questions that must be grounded in specific source material with citations.

Its SKILL.md is about 500 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Retrieval-augmented generation, Knowledge bases and Citation management. The repository describes itself as: Portable AI agent runtime for the JVM. One @Agent class runs on Spring AI, LangChain4j, Anthropic, or 9 more behind one SPI. Token streaming, tool calls, human approvals, and… The licence is Apache-2.0.

When your agent uses it

  • Answering questions that must be grounded in specific source material with citations
  • Tasks that involve Retrieval-augmented generation
  • Tasks that involve Knowledge bases

Example prompts

  • “/rag-assistant”

Workflow steps

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

  1. Search the knowledge base for relevant documents
  2. Read the most relevant documents carefully
  3. Compose your answer using ONLY information from the documents
  4. Cite which document(s) your answer draws from
  5. If the documents don't contain enough information, say so honestly

What it can do on your machine

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

    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

RAG Assistant loads about 504 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 229 words of instructions outside code blocks.

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

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 Atmosphere/atmosphere at commit 13671cf, republished under its Apache-2.0 licence (© Atmosphere). 229 words, ~504 tokens.

Download SKILL.mdSave it as .claude/skills/rag-assistant/SKILL.md (or your agent's skills folder).
name
rag-assistant
description
Knowledge base assistant that retrieves and cites documents from a curated index. Use when answering questions that must be grounded in specific source material with citations.
metadata.category
rag
metadata.tags
rag, retrieval, embeddings, documents, knowledge-base

Atmosphere Knowledge Assistant

You are a knowledgeable assistant that answers questions about the Atmosphere Framework using a curated knowledge base of documentation.

You have access to tools that let you search and read the knowledge base. Use them proactively -- don't guess, look it up:

  • search_knowledge_base -- find documents matching a topic or keyword
  • list_sources -- see what documents are available
  • get_document_excerpt -- read a specific document in full

How to answer questions:

  1. Search the knowledge base for relevant documents
  2. Read the most relevant documents carefully
  3. Compose your answer using ONLY information from the documents
  4. Cite which document(s) your answer draws from
  5. If the documents don't contain enough information, say so honestly

Keep responses concise and under 500 words unless asked for more detail.

Skills

  • Answer questions about the Atmosphere Framework using RAG retrieval
  • Search and browse the knowledge base
  • Explain transports, AI modules, agents, and getting started
  • Compare features across documentation topics

Tools

  • search_knowledge_base: Search documents for relevant information by topic or keyword
  • list_sources: Enumerate all available knowledge base documents
  • get_document_excerpt: Read a specific document in full by reference

Guardrails

  • Use ONLY information from the knowledge base -- never fabricate facts
  • If a question cannot be answered from the documents, say so explicitly
  • Always cite which document(s) your answer comes from
  • Keep responses concise and well-structured
  • Recommend the official documentation for topics not covered in the knowledge base

© Atmosphere, Apache-2.0. 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 modules/skills/src/main/resources/META-INF/skills/rag-assistant of Atmosphere/atmosphere.

Open the folder on GitHubat commit 13671cf

Compare with similar skills

RAG Assistant 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.

RAG Assistant compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
RAG Assistant this skillAtmosphere/atmosphere3.8k—~504Automated safety check: PassApache-2.0
Penguin SDKPrism-Shadow/penguin-harness2.5k—~11kAutomated safety check: PassApache-2.0
Knowledge Queryevolution-foundation/evo-nexus545—~804Automated safety check: NotesCustom licence
Gnogmickel/gno1151 repos~1.6kAutomated safety check: PassMIT
Gnogmickel/gno115—~11kAutomated safety check: PassMIT
Blockify Integrationiternal-technologies-partners/blockify-agentic-data-optimization316—~6.2kAutomated safety check: NotesCustom licence

Similar skills

  • Penguin SDK

    Prism-Shadow/penguin-harness

    A skill your agent uses whenever the user wants to build an agent application — their own program with an embedded agent, such as an AI app, an agentic app or a RAG app.

    2.5k GitHub stars~11k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Knowledge Query

    evolution-foundation/evo-nexus

    Hybrid search (vector + BM25 via RRF + metadata boost) against the pgvector Knowledge base, with optional RAG synthesis.

    545 GitHub stars~804 tokensUpdated 4 mo ago
    AI & LLM EngineeringAuto-check: notes
  • Gno

    gmickel/gno

    Search local documents, files, notes, and knowledge bases. An agent skill from gmickel/gno.

    115 GitHub starsUsed in 1 repo~1.6k tokens
    Knowledge ManagementAuto-check passed
  • Gno

    gmickel/gno

    Search local documents, files, notes, and knowledge bases. An agent skill from gmickel/gno.

    115 GitHub stars~11k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Blockify Integration

    iternal-technologies-partners/blockify-agentic-data-optimization

    Process documents with Blockify API to create optimized IdeaBlocks for RAG.

    316 GitHub stars~6.2k tokensUpdated 5 mo ago
    AI & LLM EngineeringAuto-check: notes
  • Agentsop Dify

    agentsope/SkillAlchemy

    SOP for building LLM applications on Dify — visual workflow + chatflow + agent + RAG knowledge base + plugin marketplace + observability, self-hostable.

    459 GitHub stars~5.4k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check: notes

More from Atmosphere/atmosphere

All 20 skills in this repo
  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Auto-check passed
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Auto-check passed
  • Obsidian CLI

    Atmosphere/atmosphere

    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

    3.8k GitHub starsUsed in 13 repos~795 tokens
    Auto-check passed
  • Release Sample Sweep

    Atmosphere/atmosphere

    Run the pre-release end-to-end sweep of every user-facing surface — the 33 samples under samples/ (booted from their packaged artifacts and driven in a real browser via chrome-devtools MCP), the…

    3.8k GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • Obsidian Writer

    Atmosphere/atmosphere

    Write well-formatted notes to the atmosphere-vault Obsidian knowledge base.

    3.8k GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check passed
  • Carnet

    Atmosphere/atmosphere

    Work the private register (Atmosphere/atmosphere-carnet) from a session — claim an issue before touching it so peers see who holds it and which session, release or close it when done, file new…

    3.8k GitHub stars~4k tokensUpdated 2 days ago
    Auto-check passed

Questions about RAG Assistant

What does RAG Assistant do?

Knowledge base assistant that retrieves and cites documents from a curated index. RAG Assistant is an agent skill from Atmosphere/atmosphere. Knowledge base assistant that retrieves and cites documents from a curated index.

When should I use RAG Assistant?

RAG Assistant fits situations like: answering questions that must be grounded in specific source material with citations; tasks that involve Retrieval-augmented generation; tasks that involve Knowledge bases.

How do I install RAG Assistant in Claude Code?

Run `npx skills add Atmosphere/atmosphere --skill rag-assistant -a claude-code`. Or copy the skill folder (modules/skills/src/main/resources/META-INF/skills/rag-assistant in Atmosphere/atmosphere) into .claude/skills/rag-assistant in your project. Claude Code loads it when a task matches its description.

How do I install RAG Assistant in Codex?

Run `npx skills add Atmosphere/atmosphere --skill rag-assistant -a codex`. Or copy the skill folder (modules/skills/src/main/resources/META-INF/skills/rag-assistant in Atmosphere/atmosphere) into .agents/skills/rag-assistant in your project. Codex loads it when a task matches its description.

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

What does RAG Assistant need to run?

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

Does RAG Assistant 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 RAG Assistant 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 RAG Assistant use?

RAG Assistant is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does RAG Assistant use?

About 504 tokens (SKILL.md is roughly 2k 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 RAG Assistant?

Skills that share tags, products or a category with RAG Assistant: Penguin SDK (Prism-Shadow/penguin-harness, 2.5k stars), Knowledge Query (evolution-foundation/evo-nexus, 545 stars), Gno (gmickel/gno, 115 stars) and Gno (gmickel/gno, 115 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains RAG Assistant?

Atmosphere (a GitHub organization) maintains it in Atmosphere/atmosphere, which has 3,818 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 6, 2026.

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