Skip to content

A few Claude Skills and Agent Docs#2113

Open
Hareet wants to merge 3 commits intomainfrom
add-claude-commands
Open

A few Claude Skills and Agent Docs#2113
Hareet wants to merge 3 commits intomainfrom
add-claude-commands

Conversation

@Hareet
Copy link
Member

@Hareet Hareet commented Jan 15, 2026

Summary

  • Created with the help of Agent Claude to boilerplate where doc stuff should go and review consistency
  • Add CLAUDE.md with project conventions, build commands, and style guide reference
  • Add /cht-doc command for guided documentation creation
  • Add /docs-review command for PR style guide compliance checks

Running /docs-review in Claude Code:

Recording.2026-01-14.211931.mp4

…eviewer command was helpful in suggestions for consistent styling. /cht-doc was helpful in quick guidance and questions. Something to build on.
@andrablaj
Copy link
Member

@Hareet, I started reviewing this PR but haven't finished yet. I am mostly operating from a "do no harm" perspective and double-check for eventual inconsistencies.

Question: Do we plan to also createagents.md or copilot-instructions.md files - or what would be a good approach to support other platform agents?

Copy link
Member

@sugat009 sugat009 left a comment

Choose a reason for hiding this comment

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

A few minor changes! Tested this to create a new REST endpoint in the API page and output seems to follow the pattern existing there.

Image

The above image might be too zoomed out or pixelated. 😅

- [ ] Links validated
- [ ] Appropriate shortcodes used

Ask the user to confirm they want to proceed at each major step if the task is complex.
Copy link
Member

Choose a reason for hiding this comment

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

question: how would claude classify a task as complex?

Copy link
Member Author

Choose a reason for hiding this comment

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

That's a good question.. for now, we can let it try to infer that. We should think about some examples or guard-rails. The current result of that should only mean more stops on easy tasks, which at least isn't negative.

@Hareet
Copy link
Member Author

Hareet commented Jan 22, 2026

Question: Do we plan to also createagents.md or copilot-instructions.md files - or what would be a good approach to support other platform agents?

Claude Skills can be used everywhere now, so users can point their setup to the Skill files. I was going to leave this as: people can port it or open a new PR for their preferred agent. It's a [ . ] folder, thinking along the lines of "if someone wanted to add a different cloud tool or gitlab-ci-runners" they could always add their [ . ] folder and not all similar ones.

This is more of just a starting point. If people are using it and have questions about how to use it with other agents, we can support that at that time.

@andrablaj
Copy link
Member

Thanks for the review, @sugat009, and apologies for not finishing my review of this PR myself, either. One review is sufficient - let's merge it!

@andrablaj andrablaj removed their request for review January 26, 2026 07:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: 💻 In Progress

Development

Successfully merging this pull request may close these issues.

3 participants