Add AI agent instructions and skills using open standards#679
Merged
mandre merged 1 commit intok-orc:mainfrom Feb 16, 2026
Merged
Add AI agent instructions and skills using open standards#679mandre merged 1 commit intok-orc:mainfrom
mandre merged 1 commit intok-orc:mainfrom
Conversation
eshulman2
force-pushed
the
claude-commands
branch
from
72f23f1 to
fb34220
Compare
Contributor
Author
|
/retest |
Contributor
|
Now we have a fix for the problem with pkg_resources. Could you re-run the jobs? They should now pass without problems. |
eshulman2
force-pushed
the
claude-commands
branch
from
fb34220 to
dc263f9
Compare
Contributor
Author
|
@winiciusallan done |
mandre
reviewed
Feb 13, 2026
Collaborator
mandre
left a comment
mandre
left a comment
There was a problem hiding this comment.
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.
eshulman2
force-pushed
the
claude-commands
branch
from
dc263f9 to
eca75bc
Compare
eshulman2
changed the title
Contributor
Author
|
@mandre done on the generic agents locations |
mandre
reviewed
Feb 16, 2026
| project, rs := dependency.FetchDependency( | ||
| ctx, actuator.k8sClient, obj.Namespace, filter.ProjectRef, "Project", | ||
| func(dep *orcv1alpha1.Project) bool { | ||
| return orcv1alpha1.IsAvailable(dep) && dep.Status.ID != nil |
eshulman2
force-pushed
the
claude-commands
branch
from
eca75bc to
79d3dca
Compare
mandre
reviewed
Feb 16, 2026
Collaborator
mandre
left a comment
mandre
left a comment
There was a problem hiding this comment.
This is a good start. There's just one last thing I noticed (missing a v2 prefix in the import path) then we can merge and iterate on those files.
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
force-pushed
the
claude-commands
branch
from
79d3dca to
d8176a7
Compare
mandre
approved these changes
Feb 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
Open Standards
Following review feedback, this PR uses generic naming conventions:
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!