skills.rest
petekp
petekpCOMMUNITY
Explore all skills by this author →
Website𝕏@petekpGitHub

optimize-agent-docs

Convert scattered agent docs into a retrieval-optimized knowledge base.

5|2|Updated Jan 20, 2026
Search Tags:#optimization#dotfiles#claude#retrieval#manifest#knowledge#docs
One-click install
npx skills add https://github.com/petekp/agent-skills --skill optimize-agent-docs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: optimize-agent-docs
Source: https://github.com/petekp/agent-skills/tree/main/skills/optimize-agent-docs
Command: npx skills add https://github.com/petekp/agent-skills --skill optimize-agent-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts scattered agent documentation stored in dotfiles into a structured, retrieval-optimized knowledge layer, enabling faster access and reuse.

Core Features & Use Cases

  • Knowledge extraction: inventory and parse agent docs from .claude, .codex, .cursor, and .aider sources to identify discrete facts, instructions, and context triggers.
  • Knowledge manifest: generate a compact index at .claude/KNOWLEDGE.md that maps tasks to relevant knowledge chunks.
  • Optimized artifacts: produce dense, compiled outputs in .claude/compiled for efficient agent consumption, plus retrieval hints for grep-based discovery.
  • Validation workflow: run coverage and retrieval tests to ensure all facts are indexed and easily retrievable.

Quick Start

Run the optimize-agent-docs skill to convert your dotfile documentation into a dense, retrieval-ready knowledge base.

Frequently Asked Questions about optimize-agent-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn scattered dotfile documentation into a retrieval-ready knowledge base?▼

To build a retrieval-ready knowledge base, the Skill extracts knowledge from dotfile sources, chunks it into retrieval units, and generates a compact manifest at .claude/KNOWLEDGE.md mapping tasks to relevant chunks for fast access and reuse.

What is the best way to index CLAUDE manifests and agent docs for fast retrieval?▼

Indexing CLAUDE manifests and agent docs involves parsing sources like .claude, .codex, .cursor, and .aider to identify discrete facts, then compiling dense artifacts under .claude/compiled with retrieval hints for grep-based discovery.

How does the knowledge manifest workflow optimize onboarding and debugging tasks?▼

The knowledge manifest workflow optimizes onboarding and debugging by validating coverage and retrieval tests, ensuring all documented facts are indexed and easily retrievable within the compiled knowledge layer.

Can I use this Skill to parse documentation from .codex, .cursor, and .aider sources?▼

Yes, the Skill inventories and parses agent documentation from .claude, .codex, .cursor, and .aider sources to identify discrete facts, instructions, and context triggers for the knowledge base.

What does the validation workflow check when optimizing agent docs for retrieval?▼

The validation workflow checks retrieval optimization by running coverage and retrieval tests, ensuring all extracted facts are properly indexed in the .claude/KNOWLEDGE.md manifest and easily retrievable by agents.

Related Skills

Explore More Content & Communication Skills→
songlairuisonglairui

agent-init

Normalize raw project state into a standardized handoff context for AI agents.

Community
Advanced
HelloWorldSunginHelloWorldSungin

claude-history-ingest

Your AI-powered home companion is ready to use.

Community
Advanced
liumeixinliumeixin
4

neat-freak

Synchronize project documentation and agent memory across multiple agent platforms.

Community
Advanced
MSamiulHasnatMSamiulHasnat
1

AgentDB Vector Search

Index embeddings and perform context-aware similarity queries for document retrieval.

Community
Advanced