Agent skill

RAG System Architect

by criptogus in criptogus/agent-evolve-network

Designs production retrieval-augmented generation systems: chunking, embeddings, vector store, reranking, eval.

CC-BY-SA-4.0Auto-check passedAI & LLM Engineering

Install RAG System Architect

skills CLI
$ npx skills add criptogus/agent-evolve-network --skill rag-system-architect -a claude-code

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

GitHub CLI
$ gh skill install criptogus/agent-evolve-network rag-system-architect --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/criptogus/agent-evolve-network.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/rag-system-architect .claude/skills/rag-system-architect && 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-system-architect
GitHub stars
288
Token cost
~554 tokens
SKILL.md length
159 words
Files
1
Skills in repo
107
Repo updated
First seen
Licence
CC-BY-SA-4.0

At a glance

Designs production retrieval-augmented generation systems: chunking, embeddings, vector store, reranking, eval.

  • The user asks for rag system architect work
  • SKILL.md covers Instructions, Always, Never and Examples, plus 1 more section
  • Calls npx
  • Tasks that involve Retrieval-augmented generation

What it does

RAG System Architect is an agent skill from criptogus/agent-evolve-network. Designs production retrieval-augmented generation systems: chunking, embeddings, vector store, reranking, eval. Use when the user asks for rag system architect work, or mentions rag, system, architect.

Its SKILL.md is about 550 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. The licence is CC-BY-SA-4.0.

When your agent uses it

  • The user asks for rag system architect work
  • Tasks that involve Retrieval-augmented generation

Example prompts

  • “Use the rag-system-architect skill to design production retrieval-augmented generation systems: chunking, embeddings, vector store, reranking, eval”
  • “/rag-system-architect”

Requirements

  • Node.js

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • superagentskill.com

    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 System Architect loads about 554 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 159 words of instructions outside code blocks.

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

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 criptogus/agent-evolve-network at commit d19b920, republished under its CC-BY-SA-4.0 licence (© criptogus). 159 words, ~554 tokens.

Download SKILL.mdSave it as .claude/skills/rag-system-architect/SKILL.md (or your agent's skills folder).
name
rag-system-architect
description
Designs production retrieval-augmented generation systems: chunking, embeddings, vector store, reranking, eval. Use when the user asks for rag system architect work, or mentions rag, system, architect.
version
0.1.0
license
CC-BY-SA-4.0
homepage
https://superagentskill.com/marketplace/rag-system-architect
source
Super Agent Skill (SAK)

RAG System Architect

Use when building or improving a RAG pipeline. Covers chunking strategies, embedding model choice, hybrid search, reranking, and offline eval with RAGAS-style metrics.

Instructions

You are a RAG architect. For each request, output: (1) chunking strategy with size/overlap rationale, (2) embedding model + vector store recommendation, (3) hybrid (BM25 + dense) + reranker plan, (4) eval harness (faithfulness, context precision, answer relevance). Refuse to ship without an eval set.

Always

  • Follow the section order specified in the system prompt.

Never

  • Invent APIs, URLs, or facts not grounded in the input.

Examples

Design a RAG pipeline

Input:

Q&A over 50k internal docs; answers must cite sources.

Expected output:

Chunking (structure-aware, ~512 tok + overlap), embedding model choice, vector store, hybrid (BM25 + dense) retrieval, a reranker, and citation-enforcing prompt. Defines an eval set with retrieval@k + faithfulness.
Fix poor recall

Input:

Retrieval misses obviously relevant docs.

Expected output:

Adds hybrid search + reranking, revisits chunk size/overlap, and checks embedding/domain mismatch; measures retrieval@k before/after instead of eyeballing.

Trust & telemetry

This skill is graded on the Super Agent Skill network: format, substance and adversarial (prompt-injection) testing produce a public Trust Score.

Reinstall or update with npx skills update, or pull the live graded version with npx super-agent install rag-system-architect.

© criptogus, CC-BY-SA-4.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 skills/rag-system-architect of criptogus/agent-evolve-network.

Open the folder on GitHubat commit d19b920

Compare with similar skills

RAG System Architect 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 System Architect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
RAG System Architect this skillcriptogus/agent-evolve-network288—~554Automated safety check: PassCC-BY-SA-4.0
Chroma Vector DatabaseOrchestra-Research/AI-Research-SKILLs13k8 repos~2.3kAutomated safety check: PassMIT
LLM Application DevMoizIbnYousaf/ai-agent-skills1.1k2 repos~1.3kAutomated safety check: PassMIT
Senior Prompt Engineermaslennikov-ig/claude-code-orchestrator-kit2604 repos~1.4kAutomated safety check: PassCustom licence
MCP Local RAGshinpr/mcp-local-rag407—~4.4kAutomated safety check: PassMIT
Ms Agent Framework RAGshuyu-labs/WebCode278—~1.1kAutomated safety check: PassCustom licence

Similar skills

  • Chroma Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.

    13k GitHub starsUsed in 8 repos~2.3k tokens
    AI & LLM EngineeringAuto-check passed
  • LLM Application Dev

    MoizIbnYousaf/ai-agent-skills

    Building applications with Large Language Models - prompt engineering, RAG patterns, and LLM integration.

    1.1k GitHub starsUsed in 2 repos~1.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Senior Prompt Engineer

    maslennikov-ig/claude-code-orchestrator-kit

    Provides reference guides and Python scripts for prompt optimization, RAG evaluation, and agent orchestration when building or tuning LLM systems.

    260 GitHub starsUsed in 4 repos~1.4k tokens
    AI & LLM EngineeringAuto-check passed
  • MCP Local RAG

    shinpr/mcp-local-rag

    Searches, saves, and maintains a local document index through a local RAG MCP server.

    407 GitHub stars~4.4k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Ms Agent Framework RAG

    shuyu-labs/WebCode

    Comprehensive guide for building Agentic RAG systems using Microsoft Agent Framework in C.

    278 GitHub stars~1.1k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Local RAG Search

    nkapila6/mcp-local-rag

    Efficiently perform web searches using the mcp-local-rag server with semantic similarity ranking.

    134 GitHub starsUsed in 1 repo~1.6k tokens
    AI & LLM EngineeringAuto-check passed

More from criptogus/agent-evolve-network

All 107 skills in this repo
  • Brand Research

    criptogus/agent-evolve-network

    Kickoff research for a brand you haven't worked on before — web research, existing-ad analysis from the Meta Ad Library, editorial-grammar profiling, sourced + AI-generated brand assets, hook/CTA…

    288 GitHub stars~3.9k tokensUpdated 28 days ago
    Auto-check passed
  • Create Apple Notes Video Ad

    criptogus/agent-evolve-network

    Produce a 9:16 social-native ad recreating the iPhone Apple Notes typing experience — the note begins with 1–2 visible lines, then progressively types additional paragraphs character-by-character…

    288 GitHub stars~4.9k tokensUpdated 28 days ago
    Auto-check passed
  • Create Chatgpt Video Ad

    criptogus/agent-evolve-network

    Produce a 9:16 social-native ad that recreates a ChatGPT mobile chat — user types in the composer with the iOS keyboard visible, taps send, keyboard slides down, header right-cluster swaps…

    288 GitHub stars~5k tokensUpdated 28 days ago
    Auto-check passed
  • Create Imessage Video Ad

    criptogus/agent-evolve-network

    Produce a 9:16 social-native ad that recreates an iMessage conversation reveal — bubbles pop in over time, composer types char-by-char, real Apple iMessage SFX hit on every send/receive, music bed…

    288 GitHub stars~7.4k tokensUpdated 28 days ago
    Auto-check passed
  • Cloud Misconfig Auditor

    criptogus/agent-evolve-network

    Audits AWS, GCP and Azure environments (and matching IaC) for excessive permissions, public exposure, weak encryption defaults and missing logging.

    288 GitHub stars~965 tokensUpdated 28 days ago
    Auto-check passed
  • Cloudflare Workers Expert

    criptogus/agent-evolve-network

    Builds and debugs Cloudflare Workers, Durable Objects, KV, R2, D1, and Queues with edge-correct patterns.

    288 GitHub stars~619 tokensUpdated 28 days ago
    Auto-check passed

Questions about RAG System Architect

What does RAG System Architect do?

Designs production retrieval-augmented generation systems: chunking, embeddings, vector store, reranking, eval. RAG System Architect is an agent skill from criptogus/agent-evolve-network. Designs production retrieval-augmented generation systems: chunking, embeddings, vector store, reranking, eval.

When should I use RAG System Architect?

RAG System Architect fits situations like: the user asks for rag system architect work; tasks that involve Retrieval-augmented generation.

How do I install RAG System Architect in Claude Code?

Run `npx skills add criptogus/agent-evolve-network --skill rag-system-architect -a claude-code`. Or copy the skill folder (skills/rag-system-architect in criptogus/agent-evolve-network) into .claude/skills/rag-system-architect in your project. Claude Code loads it when a task matches its description.

How do I install RAG System Architect in Codex?

Run `npx skills add criptogus/agent-evolve-network --skill rag-system-architect -a codex`. Or copy the skill folder (skills/rag-system-architect in criptogus/agent-evolve-network) into .agents/skills/rag-system-architect in your project. Codex loads it when a task matches its description.

Can I use RAG System Architect 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 criptogus/agent-evolve-network --skill rag-system-architect -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-system-architect, .gemini/skills/rag-system-architect, .github/skills/rag-system-architect and .opencode/skills/rag-system-architect in your project.

What does RAG System Architect need to run?

Going by SKILL.md and its folder, RAG System Architect needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does RAG System Architect access the network?

SKILL.md names 1 domain. As links in the text: superagentskill.com. This is read from the text; nothing was executed.

Is RAG System Architect 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 System Architect use?

RAG System Architect is published under the CC-BY-SA-4.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does RAG System Architect use?

About 554 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.

What are the alternatives to RAG System Architect?

Skills that share tags, products or a category with RAG System Architect: Chroma Vector Database (Orchestra-Research/AI-Research-SKILLs, 13k stars), LLM Application Dev (MoizIbnYousaf/ai-agent-skills, 1.1k stars), Senior Prompt Engineer (maslennikov-ig/claude-code-orchestrator-kit, 260 stars) and MCP Local RAG (shinpr/mcp-local-rag, 407 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains RAG System Architect?

criptogus (a GitHub user) maintains it in criptogus/agent-evolve-network, which has 288 GitHub stars. The repository holds 107 skills in this directory. The repository was last updated on September 9, 2026.

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