agents-md-kit · packages

Provides shared TypeScript interfaces, Zod validation schemas, and utility functions for the AGENTS.md ecosystem. It serves as the central type definition library for document structures, linting results, and validation outputs used by related parser and linter packages.

Provides a CLI and a set of utility functions for linting, validating, scaffolding, and formatting `AGENTS.md` and `SKILL.md` files. It supports recursive directory traversal, multiple output formats, and CI-friendly exit codes for automated workflows.

Enforces style, content, and best-practice standards for AGENTS.md and SKILL.md files through a set of exported functions for linting and auto-fixing. It requires a document object parsed by `@reaatech/agents-markdown-parser` to execute its rule registry.

Provides an MCP server that exposes tools for linting, validating, and scaffolding agent-related markdown files. It exports a factory function to create a configured MCP `Server` instance and a helper to start it via Stdio or StreamableHTTP transports.

Provides structured Pino logging, OpenTelemetry metrics, and dashboard generation utilities for the `@reaatech/agents-markdown-*` ecosystem. It exports a collection of logging functions, a `recordOperation` wrapper for async tasks, and a `MetricsManager` singleton to track process-level telemetry.

A Markdown AST parser that produces typed `Agents

Output reporters for lint and validation results that produce console, JSON, HTML, and GitHub-flavored Markdown reports. Exports a set of functions (`reportLintResult`, `reportJsonLintResult`, `writeHtmlReport`, `reportMarkdownLint

Generates `AGENTS.md` and `SKILL.md` documentation files for agent projects using Handlebars templates. It provides functions to scaffold directories based on a configuration object, preview file generation, and perform variable substitution.

Validates AGENTS.md and SKILL.md files against the AGENTS.md specification, providing a set of functions (`validate`, `validateAgentsMd`, `validateSkillMd`) that accept parsed documents from `@reaatech/agents-markdown-parser` and return structured validation results