skills.rest
kirvin
kirvinCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

repo-knowledge-architect

Implement a five-layer progressive disclosure model for repository documentation.

Updated Apr 3, 2026
Search Tags:#progressive disclosure#cross-linking#knowledge structure#repository optimization#repository documentation
One-click install
npx skills add https://github.com/kirvin/agent-dev-harness --skill repo-knowledge-architect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repo-knowledge-architect
Source: https://github.com/kirvin/agent-dev-harness/tree/main/plugins/kf/skills/repo-knowledge-architect
Command: npx skills add https://github.com/kirvin/agent-dev-harness --skill repo-knowledge-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of creating a well-organized and agent-optimized knowledge structure within a code repository, enhancing productivity and maintainability.

Core Features & Use Cases

  • Layered Knowledge Structure: Implements a five-layer progressive disclosure model for repository documentation.
  • Reference Lookup Docs: Generates reference lookup documents for quick access to critical information.
  • Summary Tables: Adds summary tables to long documents for easy scanning.
  • Cross-Linking: Ensures all documents are cross-linked for easy navigation.
  • Use Case: After conducting a repository knowledge audit, this Skill applies the findings to optimize the repository's knowledge structure, improving the efficiency of agents working within the repository.

Quick Start

Run kf:repo-knowledge-audit to identify issues, then apply the findings using the repo-knowledge-architect skill.

Frequently Asked Questions about repo-knowledge-architect

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

FAQPage Schema
What is a five-layer progressive disclosure model for repository documentation?▼

A five-layer progressive disclosure model structures repository documentation into tiers of detail, allowing agents to scan summaries first and access deeper reference lookup documents only when needed.

How do I optimize a code repository knowledge structure for AI agents?▼

To optimize a repository knowledge structure for agents, apply post-audit findings to generate reference lookup documents, add summary tables to long files, and wire entry-point cross-links for navigation.

Do I need to run a repository audit before restructuring documentation?▼

Yes, this Skill requires post-audit findings from a repository knowledge audit to identify existing structural issues before applying the progressive disclosure optimization workflow.

How do I add summary tables to long documents for easier scanning?▼

Summary tables are automatically generated and injected into long documents during the knowledge structure optimization process, providing quick scanning access to critical embedded information.

Why does cross-linking matter for agent-optimized workflows?▼

Cross-linking matters for agent-optimized workflows because it wires entry-point documents together, ensuring autonomous agents can seamlessly navigate the repository knowledge structure without hitting dead ends.

Can I use this knowledge structure optimization without dependencies?▼

Yes, the repository knowledge architect operates with no external dependencies, directly applying its internal scripts and references to restructure your existing repository documentation files.

Related Skills

Explore More Software Engineering Skills→
CHZarlesCHZarles
1

repo-analyze

Audit a repository across 15 dimensions and produce a prioritized GO/NO-GO report.

Community
Advanced
TrevorEdrisTrevorEdris
2

agent-md-refactor

Refactor bloated AGENTS.md files into minimal root and linked topic files.

Community
Intermediate
christopheryeochristopheryeo

starred-email

Fetch starred Gmail messages and generate summaries with follow-up extraction.

Community
Intermediate
WesleyMarinhoWesleyMarinho

agent-md-refactor

Refactor monolithic agent instruction files into linked markdown files with progressive disclosure.

Community
Intermediate