Add information priority instructions to common skill#31
Merged
Conversation
Instructs AI agents to consult skill rules and reference docs before searching external documentation. Placed in infrahub-common/SKILL.md as the single shared location loaded by all other Infrahub skills. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
BeArchiTek
requested changes
Apr 9, 2026
BeArchiTek
left a comment
BeArchiTek
left a comment
Contributor
There was a problem hiding this comment.
Anthropic’s official Agent Skills Best Practices recommends “workflow” as the standard term for any sequential process an AI should follow:
Use workflows for complex tasks — Break complex operations into clear, sequential steps.
Two reasons to prefer “workflow” here:
- Terminology collision — Our skills already use “Priority” as a column header in Rule Categories tables (CRITICAL/HIGH/MEDIUM/LOW). Using “Priority” for information sourcing order creates inconsistency, which Anthropic explicitly warns against:
Choose one term and use it throughout the skill
- Codebase convention — PR #37 already established Workflow sections across 5 skills.
- This new section is functionally a workflow (step 1: check local rules → step 2: check shared knowledge → step 3: external docs), so it should follow the same pattern.
Deploying infrahub-skills with
|
| Latest commit: |
efbe092
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://8fd5943e.infrahub-skills.pages.dev |
| Branch Preview URL: | https://ps-skill-priority-instructio.infrahub-skills.pages.dev |
BeArchiTek
approved these changes
Jun 11, 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
2 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.
Instructs AI agents to consult skill rules and reference docs before searching external documentation. Placed in infrahub-common/SKILL.md as the single shared location loaded by all other Infrahub skills.
With the skill installed, claude was completely ignoring local information and instead decided to just go search the web for information. This should ensure claude references local skill information, only reaching out to external resources as it hits the edge of what is included in the skill.