kb

Read, write, search, update, and reset knowledge cards in a local directory.

92|5|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/Agents2AgentsAI/ata --skill kb-agents2agentsai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kb
Source: https://github.com/Agents2AgentsAI/ata/tree/main/codex-rs/skills/src/assets/research/kb
Command: npx skills add https://github.com/Agents2AgentsAI/ata --skill kb-agents2agentsai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The knowledge base (KB) provides a structured, local repository of research knowledge through cards, topics, and context, enabling fast discovery, consistent updates, and controlled resets.

Core Features & Use Cases

  • Create, read, update, and delete knowledge cards stored under <kb_path>/cards with metadata and body.
  • Manage topics (overview documents) and an index that tracks taxonomy and staleness for topic overviews.
  • Persist user priorities and session history in research-context.md and maintain a chronological research-journal.

Quick Start

Create or update a knowledge-card by adding a Markdown file with YAML frontmatter to <kb_path>/cards and then use KB commands to read, search, or update cards.

Frequently Asked Questions about kb

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

FAQPage Schema
How do I organize research knowledge into searchable topics and cards?

A knowledge base of research cards provides a structured local repository that enables fast discovery, consistent updates, and controlled resets. It solves the problem of scattered research notes by organizing knowledge into cards, topics, and a research journal within a local directory.

How do I create and update knowledge cards in a local research directory?

You need a local knowledge-base structure at ~/.ata/knowledge-base that includes directories and files for cards, topics, index.json, research-context.md, and research-journal.md. This local directory setup is required before you can apply KB operations to manage your research data.

Do I need a specific local directory structure to manage research topics and journals?

You create and update knowledge cards by adding a Markdown file with YAML frontmatter to the cards directory under your local knowledge-base path. KB operations then allow you to read, write, search, update, and reset those cards and their metadata.

How does a cards-based knowledge base track topic staleness and taxonomy?

The knowledge base tracks topic staleness and taxonomy through an index.json file that manages topic overviews. It also persists user priorities and session history in research-context.md to maintain context across research sessions.

Can I reset topics and research journals in a local knowledge base without deleting cards?

Yes, the knowledge base supports controlled reset operations that target topics, the index, and research journals. This allows you to clear or reset specific overview documents and journal entries while preserving your stored knowledge cards in the local directory.