Agent skill

Llamaindex

by magnus919 in magnus919/agent-skills

Build LLM applications with the LlamaIndex framework. An agent skill from magnus919/agent-skills.

MITAuto-check passedAI & LLM Engineering

Install Llamaindex

skills CLI
$ npx skills add magnus919/agent-skills --skill llamaindex -a claude-code

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

GitHub CLI
$ gh skill install magnus919/agent-skills llamaindex --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/magnus919/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/llamaindex .claude/skills/llamaindex && 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
llamaindex
GitHub stars
115
Token cost
~3k tokens
SKILL.md length
1,208 words
Files
19 (incl. scripts, references)
Skills in repo
131
Repo updated
First seen
Licence
MIT

At a glance

Build LLM applications with the LlamaIndex framework. An agent skill from magnus919/agent-skills.

  • Works in 5 steps: Decouple retrieval chunks from synthesis… → Rerank before you generate. Hybrid… → Agents are Workflows. FunctionAgent and… → …
  • Working with LlamaIndex
  • SKILL.md covers Key Principles, Where to Start, Pipeline Mode and Quick Reference, plus 6 more sections
  • Runs Python scripts from its folder

What it does

Llamaindex is an agent skill from magnus919/agent-skills. Build LLM applications with the LlamaIndex framework. Use when working with LlamaIndex or comparing RAG and agent orchestration frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files, including scripts and reference files (for example `README.md`, `evals/evals.json` and `references/agent-patterns.md`).

It sits in AI & LLM Engineering, covering Multi-agent orchestration and Retrieval-augmented generation. It works with LlamaIndex. The repository describes itself as: Curated collection of AI agent skills for Hermes and other agent frameworks. The licence is MIT.

When your agent uses it

  • Working with LlamaIndex
  • Comparing RAG and agent orchestration frameworks
  • Unrelated requests
  • Route to the nearest named specialist

Example prompts

  • “/llamaindex”

Requirements

  • Python 3

Workflow steps

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

  1. Decouple retrieval chunks from synthesis chunks. The embedding representation that retrieves well differs from the context representation…
  2. Rerank before you generate. Hybrid retrieval + reranker is the minimum viable production RAG configuration.
  3. Agents are Workflows. FunctionAgent and AgentWorkflow are pre-configured Workflows. Drop to raw Workflow when you need custom control flow.
  4. Graphs are not just vector stores. PropertyGraphIndex adds structural path traversal that vector similarity cannot provide — combine both…
  5. Evaluate in the same process. Span-attached evaluation preserves the connection between the output and the retrieval context that produced…

What it can do on your machine

Read from SKILL.md and the folder at commit 22b4723. 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/ (Python, 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

Llamaindex loads about 3k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 59 tokens; SKILL.md has 1,208 words of instructions outside code blocks.

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

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 magnus919/agent-skills at commit 22b4723, republished under its MIT licence (© magnus919). 1,208 words, ~2,999 tokens.

Download SKILL.mdSave it as .claude/skills/llamaindex/SKILL.md (or your agent's skills folder). This skill also uses 18 other files; get the full folder from GitHub.
name
llamaindex
description
Build LLM applications with the LlamaIndex framework. Use when working with LlamaIndex or comparing RAG and agent orchestration frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist.
license
MIT
metadata.author
Magnus Hedemark
metadata.version
1.3.0
metadata.source
https://github.com/run-llama/llama_index

LlamaIndex Expert Skill

LlamaIndex is an MIT-licensed Python framework for building LLM applications over your data. In 2026, it has evolved from a RAG indexing library into an event-driven workflow framework with integrated production runtime (llama-deploy), agent orchestration (AgentWorkflow), knowledge graph construction (PropertyGraphIndex), and OpenTelemetry-native observability.

The framework is organized around seven core primitives: Reader (data loaders), Document/Node (chunked content model), Index (data structures over Nodes), Retriever (relevant Node selection), Query Engine (retriever + synthesis), Agent (LLM with tools), and Workflow (event-driven orchestration).

Key Principles

These principles govern every decision when building with LlamaIndex. Read them before proceeding to the reference guides.

  1. Decouple retrieval chunks from synthesis chunks. The embedding representation that retrieves well differs from the context representation that generates well. Use SentenceWindowNodeParser + MetadataReplacementNodePostProcessor for this pattern.
  2. Rerank before you generate. Hybrid retrieval + reranker is the minimum viable production RAG configuration.
  3. Agents are Workflows. FunctionAgent and AgentWorkflow are pre-configured Workflows. Drop to raw Workflow when you need custom control flow.
  4. Graphs are not just vector stores. PropertyGraphIndex adds structural path traversal that vector similarity cannot provide — combine both for maximum retrieval quality.
  5. Evaluate in the same process. Span-attached evaluation preserves the connection between the output and the retrieval context that produced it.

Where to Start

The pipeline has 9 phases from Ingest to Deploy. If you're joining mid-stream with existing work, find your entry point:

You already have...Start at phaseWhat to do
Nothing — blank projectIngestSet up data loading, then proceed through the full pipeline
Documents in a directoryChunkChoose a chunking strategy, build your index
A working vector indexRetrieveAdd hybrid search, reranking, metadata filters
An existing RAG pipeline to hardenDeployAdd observability, llama-deploy, production debugging
A need to measure and improve qualityEvaluateSet up evaluators, ParamTuner, span-attached scoring
Nothing — comparing frameworksSee Framework Routing GuideDon't start the pipeline — pick the right tool first

Pipeline Mode

Different tasks need different levels of rigor. Match your scope to a mode:

ModeWhenPhases to runSkip
QuickSingle query, one source, explorationIngest → Chunk → Index → RetrieveReranking, metadata filters, observability, evaluation
FullProduction RAG, multiple sources, complianceIngest → Chunk → Index → Retrieve → Agent/Workflow → Deploy → EvaluateNothing — run all phases
EvaluateBenchmarking, regression testingIngest → Chunk → Index → EvaluateRetrieve, Agent, Workflow, Deploy (run offline)
GraphKnowledge graph constructionIngest → Chunk → Graph → RetrieveAgent, Workflow, Deploy (query via graph index directly)

Rule of thumb: if you're shipping to users, run Full mode. If you're exploring, run Quick. If you're measuring, run Evaluate.

Quick Reference

PhaseTaskApproachReference
IngestLoad dataSimpleDirectoryReader("./data").load_data()references/architecture.md
ChunkParse documents into nodesSentenceSplitter(chunk_size=1024)references/rag-strategies.md
IndexBuild vector indexVectorStoreIndex.from_documents(docs)references/rag-strategies.md
RetrieveHybrid search + rerankBM25Retriever + CohereRerankreferences/rag-strategies.md
AgentMulti-agent orchestrationAgentWorkflow(agents=[...])references/agent-patterns.md
WorkflowEvent-driven pipelineclass MyFlow(Workflow): @stepreferences/workflows.md
GraphKnowledge graphPropertyGraphIndex.from_documents(docs)references/property-graph-index.md
EvaluateRAG evaluationFaithfulnessEvaluator().evaluate_response(...)references/evaluation-observability.md
DeployProduction deploymentdeploy_workflow(workflow=MyFlow())references/production-deployment.md

When to Use This Skill

Load this skill any time you are:

  • Building a RAG pipeline over enterprise or personal data
  • Comparing LlamaIndex with LangChain, Haystack, or DSPy
  • Designing multi-agent systems with handoff between specialist agents
  • Deploying an LLM application to production with observability
  • Constructing knowledge graphs from unstructured documents
  • Debugging common LlamaIndex failures (retrieval miss, handoff bug, async issues)

When NOT to Use LlamaIndex — Framework Routing Guide

This skill is part of a portfolio of framework skills. When deciding which framework fits, use this routing table:

ScenarioReach forWhy
I have documents I need to queryLlamaIndexData ingestion, hybrid retrieval, reranking, and knowledge graphs are first-class primitives
I have agents I need to orchestrateLangGraphState-machine semantics, time-travel debugging, and human-in-the-loop pauses are the core design
I have a tool I need to wrap as an agentPydanticAIType-safe agent definitions with dependency injection, minimal abstraction over LLM calls
Data-heavy RAG over PDFs, SQL, Slack, 200+ sourcesLlamaIndexLlamaHub connectors, LlamaParse for documents, hybrid retrieval out of the box
Complex multi-agent state machines with checkpointsLangGraphGraph topology control — supervisor, subgraphs, hierarchical teams, built-in checkpointer
Agent-centric app where type safety matters more than data pipelinesPydanticAIAgents as Pydantic models, DI, structured outputs — the data layer is your code
Document parsing quality matters (tables, charts, handwriting)LlamaIndexLlamaParse is purpose-built for this
Production NLP search pipelinesHaystackPipeline composition model is more mature for search-specific workloads
Optimization-driven prompt programmingDSPyCompiled prompt programs, not retrieval pipelines
Show full SKILL.md (479 more words)Show less

Reference Files

ReferenceLoad whenFile
Core ArchitectureUnderstanding the 7 primitives, Settings, data flowreferences/architecture.md
RAG StrategiesBuilding RAG pipelines from basic to advancedreferences/rag-strategies.md
Agent PatternsMulti-agent orchestration with AgentWorkflowreferences/agent-patterns.md
WorkflowsEvent-driven step composition and durable executionreferences/workflows.md
Production & Deploymentllama-deploy, debugging, failure modesreferences/production-deployment.md
Property Graph IndexKnowledge graph construction and hybrid retrievalreferences/property-graph-index.md
Evaluation & ObservabilityMetrics, tracing, span-attached scoringreferences/evaluation-observability.md
Integration EcosystemVector stores, LlamaHub, LlamaParse, ecosystemreferences/integration-ecosystem.md
FAQ & TroubleshootingCommon errors and their fixesreferences/faq-and-troubleshooting.md
Worked RAG ExampleComplete end-to-end pipeline from ingest to deployreferences/example-rag-pipeline.md
Evaluation WorkflowParamTuner, evaluators, batch scoring, best practicesreferences/evaluation-workflow.md

Template Files

TemplateWhen to useFile
Basic RAGSingle-source query, getting startedtemplates/basic-rag.py
Agentic RAGMulti-source data with agent routingtemplates/agentic-rag.py
Custom WorkflowCustom control flow, branching logictemplates/custom-workflow.py
Production DeployWrapping a workflow as a microservicetemplates/production-deploy.py

Scripts

ScriptPurposeFile
check-setupVerify LlamaIndex installation and configurationscripts/check-setup.py

Troubleshooting — Structured Recovery Guide

When something goes wrong, find your symptom and follow the recovery path:

Retrieval & Answer Quality
SymptomLikely causeImmediate fixPermanent fixReference
Answers are poor or hallucinatedNo reranker on hybrid retrievalAdd CohereRerank(top_n=5) as node_postprocessorReranking is mandatory for any production RAGreferences/rag-strategies.md
Retrieval misses obvious contentDefault chunking breaks semanticsSwitch to SemanticSplitterNodeParser(breakpoint_percentile_threshold=95)Tune chunk size with ParamTunerreferences/rag-strategies.md
Wrong tenant's data returnedMissing metadata filtersAdd MetadataFilters(filters=[ExactMatchFilter(key="tenant_id", ...)])Always wire metadata filters at retriever levelreferences/rag-strategies.md
Only one type of query works wellSingle retrieval strategyCombine BM25 + vector via hybrid retrieverAdd RouterQueryEngine for query-type routingreferences/rag-strategies.md
Agent & Workflow Failures
SymptomLikely causeImmediate fixPermanent fixReference
Agent waits silently after handoffAgentWorkflow handoff bugExtend FunctionAgent.take_step to re-locate last user messageApply the handoff fix on all production agentsreferences/agent-patterns.md
Workflow doesn't runForgot awaitAdd await before w.run(...) and all step callsAll step methods are async coroutinesreferences/workflows.md
Step executes but result is lostState not persistedUse ctx.store.edit_state() for shared stateOnly ctx.store survives across stepsreferences/workflows.md
Crash loses all progressNo checkpoint snapshotsAdd Context.to_dict() save on step completionDurable workflows need explicit checkpointingreferences/workflows.md
Deployment & Observability
SymptomLikely causeImmediate fixPermanent fixReference
llama-deploy deployed but requests time outRedis not runningStart redis-serverRedis is mandatory — control plane won't route without itreferences/production-deployment.md
Spans missing in observability UIInstrumentation called too lateMove instrument() call before workflow instantiationAlways instrument before creating any Workflow objectreferences/production-deployment.md
Wrong data returned (cross-tenant)Missing metadata filtersAdd tenant filter to all retrieversFilter at retriever level, not in post-processingreferences/production-deployment.md
Recovery Workflow

For any failure, follow this cycle:

  1. Identify the symptom from the tables above
  2. Apply the immediate fix — this gets you running
  3. Implement the permanent fix — this prevents recurrence
  4. Verify with evaluation — run FaithfulnessEvaluator on a held-out query set
  5. Document the fix — add the root cause to references/faq-and-troubleshooting.md

© magnus919, 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 18 other files (scripts, references) in llamaindex of magnus919/agent-skills.

  • SKILL.md
  • README.md
  • evals/evals.json
  • references/agent-patterns.md
  • references/architecture.md
  • references/evaluation-observability.md
  • references/evaluation-workflow.md
  • references/example-rag-pipeline.md
  • references/faq-and-troubleshooting.md
  • references/integration-ecosystem.md
  • references/production-deployment.md
  • references/property-graph-index.md
  • references/rag-strategies.md
  • references/workflows.md
  • scripts/check-setup.py
  • templates/agentic-rag.py
  • templates/basic-rag.py
  • … and 2 more

Open the folder on GitHubat commit 22b4723

Compare with similar skills

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

Llamaindex compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Llamaindex this skillmagnus919/agent-skills115—~3kAutomated safety check: PassMIT
Oracle Agent Team OrchestratorBald0Wang/DeepSeek-Oracle187—~551Automated safety check: PassNone
Agent Squad for TypeScript2FastLabs/agent-squad7.8k—~4.3kAutomated safety check: PassApache-2.0
Sentence Transformers EmbeddingsOrchestra-Research/AI-Research-SKILLs13k2 repos~1.6kAutomated safety check: PassMIT
Dive Into LangGraphluochang212/dive-into-langgraph457—~837Automated safety check: NotesCustom licence
Ms Agent Framework RAGshuyu-labs/WebCode278—~1.1kAutomated safety check: PassCustom licence

Similar skills

  • Oracle Agent Team Orchestrator

    Bald0Wang/DeepSeek-Oracle

    Orchestrate DeepSeek Oracle multi-agent workflows by routing user intents to specialist oracle skills, enforcing safety gates, and composing one unified answer with follow-up questions and action…

    187 GitHub stars~551 tokensUpdated 7 mo ago
    AI & LLM EngineeringAuto-check passed
  • Agent Squad for TypeScript

    2FastLabs/agent-squad

    Guide to building Node.js and TypeScript apps on the agent-squad package: orchestrator, agent types, classifier routing, storage, retrievers and MCP tools.

    7.8k GitHub stars~4.3k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Sentence Transformers Embeddings

    Orchestra-Research/AI-Research-SKILLs

    Generates text embeddings locally with the sentence-transformers library for RAG, semantic search, clustering and similarity, with model picks for general, multilingual and legal text.

    13k GitHub starsUsed in 2 repos~1.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Dive Into LangGraph

    luochang212/dive-into-langgraph

    A Chinese-language guide and reference for building agents with LangGraph 1.0, from a first ReAct agent through middleware, memory, MCP, RAG and web search.

    457 GitHub stars~837 tokensUpdated 29 days ago
    AI & LLM EngineeringAuto-check: notes
  • 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
  • Pinecone Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to use Pinecone, a managed vector database, for production RAG, semantic search and recommendations: indexes, upserts, queries, filters and namespaces.

    13k GitHub starsUsed in 5 repos~2k tokens
    DatabasesAuto-check passed

More from magnus919/agent-skills

All 131 skills in this repo
  • Artifact Pyramids

    magnus919/agent-skills

    Organize durable agent research outputs as summaries, analysis, and evidence dossiers.

    119 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Ascii City Engine

    magnus919/agent-skills

    Build portable, first-person colored ASCII city engines and small GIS-derived city packs.

    119 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Color Management

    magnus919/agent-skills

    Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.

    119 GitHub stars~2.6k tokensUpdated today
    Auto-check: notes
  • Data Scientist

    magnus919/agent-skills

    A skill your agent uses for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research…

    119 GitHub stars~4.1k tokensUpdated today
    Auto-check passed
  • Docker Compose

    magnus919/agent-skills

    Use Docker Compose to define, run, debug, and harden multi-container applications.

    115 GitHub stars~2k tokensUpdated yesterday
    Auto-check: notes
  • Fpga Development

    magnus919/agent-skills

    Design, review, simulate, and verify FPGA logic using explicit RTL contracts, clock and reset models, CDC analysis, timing constraints, and reproducible implementation evidence.

    115 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Llamaindex

What does Llamaindex do?

Build LLM applications with the LlamaIndex framework. An agent skill from magnus919/agent-skills. Llamaindex is an agent skill from magnus919/agent-skills. Build LLM applications with the LlamaIndex framework.

When should I use Llamaindex?

Llamaindex fits situations like: working with LlamaIndex; comparing RAG and agent orchestration frameworks; unrelated requests; route to the nearest named specialist.

How do I install Llamaindex in Claude Code?

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

How do I install Llamaindex in Codex?

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

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

What does Llamaindex need to run?

Going by SKILL.md and its folder, Llamaindex needs Python for the scripts in its folder. Our summary lists: Python 3.

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

Llamaindex is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Llamaindex use?

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

What are the alternatives to Llamaindex?

Skills that share tags, products or a category with Llamaindex: Oracle Agent Team Orchestrator (Bald0Wang/DeepSeek-Oracle, 187 stars), Agent Squad for TypeScript (2FastLabs/agent-squad, 7.8k stars), Sentence Transformers Embeddings (Orchestra-Research/AI-Research-SKILLs, 13k stars) and Dive Into LangGraph (luochang212/dive-into-langgraph, 457 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Llamaindex?

magnus919 (a GitHub user) maintains it in magnus919/agent-skills, which has 115 GitHub stars. The repository holds 131 skills in this directory. The repository was last updated on October 10, 2026.

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