AGNTCY Blogs

This repository hosts the source code for the AGNTCY engineering blog. Our mission is to share technical insights, deep-dives, and updates about the open-source projects and technologies developed at AGNTCY, including:

• Agent Directory Service: The trusted registry for discovering and verifying AI agents.
• OASF (Open Agent Safety Framework): Standards and tooling for responsible and safe agentic systems.
• Slim: A lightweight, efficient framework for building production-ready AI agents.

Local Development

This site is built with Jekyll and managed with Task.

Prerequisites

• Ruby 3.0 or higher
• Task
• Bundler (gem install bundler)
• Lychee (for link checking)
• Codespell (for spelling; pip install codespell)
• PyMarkdown (for Markdown; pip install pymarkdownlnt)
• Node.js 20.19.5 or higher (only for building slide decks under presentations/). task run still starts the Jekyll site if your Node version is older; the embedded slides are skipped.

Usage

Use the Taskfile to manage common operations:

1. Install dependencies:

   task deps

2. Run the local development server:

   task run

   The site will be available at http://0.0.0.0:4000/.

3. Build the static site:

   task build

   The output will be generated in the _site/ directory.

4. Lint spelling, Markdown, and links:

   task lint

   This runs Codespell and PyMarkdown on the source, then builds the Jekyll site and checks _site/ with Lychee. Slide decks are not required for local lint; CI builds them and checks their links. Link checks also run daily on main. Use task lint:fix to apply automatic spelling and Markdown fixes.

Contributing

See CONTRIBUTING.md for how to propose posts, submit pull requests, and work with maintainers.

Please adhere to Conventional Commits for all commit messages. Review .github/CODEOWNERS for repository maintainers.