common-skills/skills/docs-rag/SKILL.md

name, description

name

description

docs-rag

3GPP technical specification document retrieval and index management. Use when the user asks about 3GPP specs, Release 19 features, mission critical services, ambient IoT, ISAC, UAV/drone support, network sharing, SNPN interconnect, traffic steering/split, or any question answered by the local docs/ directory. Also use when the user wants to update, rebuild, or refresh the docs index, or when new documents have been added to the docs/ directory.

3GPP Docs RAG Skill

Lightweight retrieval-augmented generation over the local docs/ directory of 3GPP Release 19 specifications and study reports.

Directory Layout

.kiro/skills/docs-rag/
├── SKILL.md          ← this file
├── data/
│   └── index.json    ← document index (spec, title, keywords, summary, file path)
└── evals/
    └── evals.json    ← evaluation cases
scripts/
└── build_index.py    ← index builder / updater

Maintaining the Index

Full rebuild (after adding many new docs):

python scripts/build_index.py

Incremental update (add new docs or refresh changed ones):

python scripts/build_index.py --update

The script scans docs/ for .docx / .doc files, extracts the scope section and header metadata, and writes data/index.json. Unchanged files (same mtime) are skipped in --update mode.

How to Answer Queries

1. Read .kiro/skills/docs-rag/data/index.json.
2. Match the user's query against keywords and summary fields.
3. If the summary is sufficient, answer directly from it.
4. If deeper detail is needed, read the actual file at the file path.

Document Index Summary

Spec	Title	Key Topics
TS 22.280	Mission Critical Services Common Requirements	MCPTT, MCData, MCVideo, public safety
TS 22.369	Service Requirements for Ambient IoT	battery-less IoT, energy harvesting
TR 22.837	Integrated Sensing and Communication (ISAC)	NR sensing, V2X, UAV, smart city
TR 22.840	Study on Ambient Power-enabled IoT	ambient IoT, 5G service requirements
TR 22.841	Traffic Steer/Switch/Split over Dual 3GPP Access	multi-access, PLMN, satellite NR
TR 22.843	UAV Phase 3	drone, flight management, UTM, QoS
TR 22.848	Interconnect of SNPN	private network, SNPN, PLMN interconnect
TR 22.851	Network Sharing Feasibility Study	NG-RAN sharing, mobility, charging

Retrieval Rules

• Keyword match: scan keywords array for overlap with user query terms.
• Semantic match: if no keyword hit, check summary for conceptual relevance.
• Multi-doc: return all relevant docs when the query spans multiple topics.
• No match: say so clearly rather than hallucinating.

Answer Format

Always cite the spec number and version:

According to 3GPP TR 22.843 V19.2.0, the 5G system supports UAV flight path recommendation and inflight monitoring based on network QoS information.