Skip to content

Add agentify-openapi skill β€” generate AGENTS.md from OpenAPI specs πŸ€–πŸ€–πŸ€–#1295

Open
koriyoshi2041 wants to merge 1 commit intogithub:stagedfrom
koriyoshi2041:add-agentify
Open

Add agentify-openapi skill β€” generate AGENTS.md from OpenAPI specs πŸ€–πŸ€–πŸ€–#1295
koriyoshi2041 wants to merge 1 commit intogithub:stagedfrom
koriyoshi2041:add-agentify

Conversation

@koriyoshi2041
Copy link
Copy Markdown

Summary

Adds a new skill agentify-openapi that teaches GitHub Copilot how to use Agentify (agentify-cli on npm) to transform OpenAPI specifications into agent interface files.

What Agentify does:

  • Takes any OpenAPI spec (Swagger 2.0 or OAS 3.x) as input
  • Generates up to 9 agent interface formats: AGENTS.md, MCP Server, CLAUDE.md, .cursorrules, Skills, llms.txt, GEMINI.md, A2A Card, and CLI
  • Automatically selects a tiered generation strategy based on API size (small/medium/large) to avoid context window overflow
  • MIT licensed, TypeScript, available as npx agentify-cli transform <spec>

Why this skill is useful:

  • Complements the existing create-agentsmd skill (which writes AGENTS.md manually) by offering automated generation from an OpenAPI spec
  • Helps teams with existing REST APIs quickly generate standardized agent interface files
  • Supports the AGENTS.md standard adopted by 60K+ repositories

Contribution checklist:

  • Branch created from staged
  • Skill validates (npm run skill:validate passes)
  • README updated (npm start ran, docs/README.skills.md updated)
  • Follows SKILL.md frontmatter format with name and description
  • No paid services required β€” fully open-source (MIT)

Links

Add agentify-openapi skill: a CLI tool (agentify-cli on npm) that
transforms OpenAPI specifications into 9 agent interface formats
including AGENTS.md, MCP servers, CLAUDE.md, .cursorrules, Skills,
llms.txt, GEMINI.md, A2A Card, and standalone CLI.

GitHub: https://github.com/koriyoshi2041/agentify
License: MIT
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 4, 2026

πŸ” Skill Validator Results

2 resource(s) checked | βœ… All checks passed

Full output
Found 1 skill(s)
[agentify-openapi] πŸ“Š agentify-openapi: 1,165 BPE tokens [chars/4: 1,183] (detailed βœ“), 19 sections, 8 code blocks
[agentify-openapi]    ⚠  No numbered workflow steps β€” agents follow sequenced procedures more reliably.
οΏ½[32mβœ… All checks passed (1 skill(s))οΏ½[0m

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant