github cloudposse/atmos v1.226.0-rc.3

pre-release54 minutes ago
feat(ai): browsable, searchable Agent Skills Directory @osterman (#2881) ## what
  • Adds a generated, browsable, searchable Agent Skills Directory at /ai/skills, replacing the hand-maintained (and drifted) skill table on the Agent Skills doc page.
  • Extends the file-browser Docusaurus plugin with category grouping, a search box, configurable card icon/CTA label, and a "Copy as Markdown" button, reused for the new skills instance.
  • The "Copy as Markdown" button (skills only) concatenates a skill's SKILL.md and every nested reference file into one clipboard-ready document, so its full context can be grabbed without installing it.
  • atmos ai skill list gains a --format flag (table/json/yaml/csv/tsv) and a Category column.
  • Adds a SkillCount component that renders the live, build-time skill count inline in prose (homepage AISection, docs), so counts can't drift out of date again.
  • Restructures the sidebar nav (Atmos AISkills category with Agent Skills, Skill Marketplace, and a link to the new directory) and cleans up a duplicate "Native CI" sidebar/doc link.
  • Adds the changelog post and roadmap entry for this feature, and fixes pre-existing EditorConfig indentation violations in several SKILL.md files surfaced by the affected-file validator.

why

  • The old skill list page was hand-maintained and had drifted to roughly half the real skill count, with stale entries pointing at skills that no longer exist. There was also no way to search, filter, or grab a skill's content without installing it.
  • Generating the directory from the skills themselves, and computing counts at build time, makes it structurally impossible for the docs to fall out of sync again.

references

  • Blog post: /blog/agent-skills-directory
  • Docs: /ai/skills, /ai/agent-skills

Summary by CodeRabbit

  • New Features

    • Added a browsable, searchable Agent Skills Directory with categorized skill pages.
    • Added Markdown copying and one-click installation command guidance for skills.
    • Added table, JSON, YAML, CSV, and TSV output formats to skill listings.
    • Added skill categories and dynamic skill counts.
    • Added reusable command displays with clipboard copying.
  • Bug Fixes

    • Empty JSON skill listings now return [] instead of null.
  • Documentation

    • Updated AI, native CI, scaffold, and navigation documentation.
    • Added an Agent Skills Directory announcement.
  • Style

    • Improved directory search, cards, layout, sidebar behavior, and dark-theme presentation.

Don't miss a new atmos release

NewReleases is sending notifications on new releases.