Skip to content

Add AI agent instructions and skills using open standards#679

Open
eshulman2 wants to merge 1 commit intok-orc:mainfrom
eshulman2:claude-commands
Open

Add AI agent instructions and skills using open standards#679
eshulman2 wants to merge 1 commit intok-orc:mainfrom
eshulman2:claude-commands

Conversation

@eshulman2
Copy link
Contributor

@eshulman2 eshulman2 commented Feb 9, 2026

Add AGENTS.md with project-specific instructions for AI-assisted
development of ORC controllers, including project structure, key
patterns, and references to detailed documentation.

Add skills for common development workflows:

  • /new-controller: Scaffold and implement new ORC controllers
  • /update-controller: Modify existing controllers (add fields, tags, etc.)
  • /add-dependency: Add resource dependencies to controllers
  • /proposal: Write enhancement proposals following the template
  • /testing: Run unit tests, linting, and E2E tests

Open Standards

Following review feedback, this PR uses generic naming conventions:

  • AGENTS.md is the main instruction file (open standard)
  • CLAUDE.md is a symlink for Claude Code compatibility
  • .agents/skills/ contains the skills (Agent Skills open standard)
  • .claude/skills/ symlinks to .agents/skills/ for Claude Code

This ensures compatibility with multiple AI coding assistants while
avoiding vendor lock-in.

Skills follow the Agent Skills open standard with SKILL.md format.

Tested locally and compared with already proposed controller (loadbalancer), did a great job mostly similar to what I did with some possible improvements!

@github-actions github-actions bot added the semver:patch No API change label Feb 9, 2026
@eshulman2
Copy link
Contributor Author

/retest

@winiciusallan
Copy link
Contributor

Now we have a fix for the problem with pkg_resources. Could you re-run the jobs? They should now pass without problems.

openstack/devstack@1dee5d0

@eshulman2
Copy link
Contributor Author

@winiciusallan done

Copy link
Collaborator

@mandre mandre left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is great, thanks @eshulman2. This has been on my TODO list for a while to add AGENTS.md and a good set of skills for the project, I'm glad you took care of it.

I just have a ask: can we try to respect the standards so that more agents can benefit from it?

I'd like the AGENTS.md file to be the source of truth. Likewise, I'd like skills to be located in a .agents/skills directory.

Add AGENTS.md with project-specific instructions for AI-assisted
development of ORC controllers, including project structure, key
patterns, and references to detailed documentation. CLAUDE.md is
a symlink for Claude Code compatibility.

Add skills for common development workflows in .agents/skills/:
- /new-controller: Scaffold and implement new ORC controllers
- /update-controller: Modify existing controllers (add fields, tags, etc.)
- /add-dependency: Add resource dependencies to controllers
- /proposal: Write enhancement proposals following the template
- /testing: Run unit tests, linting, and E2E tests

Skills follow the Agent Skills open standard (SKILL.md format).
.claude/skills/ symlinks to .agents/skills/ for Claude Code support.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@eshulman2 eshulman2 changed the title Add AI md files and claude commands Add AI agent instructions and skills using open standards Feb 15, 2026
@eshulman2
Copy link
Contributor Author

@mandre done on the generic agents locations

@eshulman2 eshulman2 requested a review from mandre February 15, 2026 14:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

semver:patch No API change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants