Skip to content

Comments

agent: update custom commands to follow Claude Code slash commands guide#12

Merged
p-iknow merged 2 commits intomainfrom
i8-agent/update-all-custom-commands-to-follow-claude-code-slash-commands-guide
Oct 25, 2025
Merged

agent: update custom commands to follow Claude Code slash commands guide#12
p-iknow merged 2 commits intomainfrom
i8-agent/update-all-custom-commands-to-follow-claude-code-slash-commands-guide

Conversation

@p-iknow
Copy link
Contributor

@p-iknow p-iknow commented Oct 25, 2025

Requirement

Resolves #8

Update all existing custom Claude Code commands to follow the official slash commands guide at https://docs.claude.com/en/docs/claude-code/slash-commands

The guide mandates frontmatter metadata for better discoverability, context provision, and proper tool integration. Commands without frontmatter lack the metadata that SlashCommand tool uses for context and user guidance.

Implementation

Updated make-branch.md

  • Added YAML frontmatter:
    • description: Brief explanation for SlashCommand tool context
    • argument-hint: Shows expected input format [<type>]: <description>\n#<issue-index>
    • allowed-tools: Specifies Bash(git checkout:*) permission for branch creation
  • Preserved all existing content structure

Updated make-pr.md

  • Added YAML frontmatter:
    • description: Explains command purpose for SlashCommand tool context
    • allowed-tools: Specifies Bash(gh:*) and Bash(git:*) permissions for PR workflow
  • No argument-hint needed as command doesn't accept arguments
  • Preserved all existing content structure

No changes to make-commit.md and make-task-issue.md

  • Both already have proper frontmatter following the guide
  • Already compliant with best practices

Test

  • Verified frontmatter syntax is valid YAML
  • Confirmed all required fields per guide are present (description, allowed-tools)
  • Validated argument-hint format matches guide examples
  • Ensured existing command functionality is preserved

Reference

Human Check

🤖 Generated with Claude Code

  • I reviewed it

이영창(piknow) and others added 2 commits October 25, 2025 15:10
Requirement:
Follow the official Claude Code slash commands guide (https://docs.claude.com/en/docs/claude-code/slash-commands) which requires frontmatter metadata for better discoverability and context.

Implementation:
- Added YAML frontmatter to make-branch.md:
  - description: Brief explanation for SlashCommand tool context
  - argument-hint: Shows expected input format to guide users
  - allowed-tools: Specifies Bash(git checkout:*) permission needed
- Preserved all existing content structure (Usage, Template, Examples, Workflow)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Requirement:
Follow the official Claude Code slash commands guide which mandates frontmatter metadata for proper tool integration and user guidance.

Implementation:
- Added YAML frontmatter to make-pr.md:
  - description: Explains command purpose for SlashCommand tool context
  - allowed-tools: Specifies Bash(gh:*) and Bash(git:*) permissions needed for PR creation workflow
- Preserved all existing content (Usage, Purpose, PR Body Generation, Workflow sections)
- No argument-hint needed as command doesn't accept arguments

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions github-actions bot added the agent Agent rules and commands label Oct 25, 2025
@p-iknow p-iknow marked this pull request as ready for review October 25, 2025 06:15
@p-iknow p-iknow merged commit d5f6a79 into main Oct 25, 2025
4 checks passed
@p-iknow p-iknow deleted the i8-agent/update-all-custom-commands-to-follow-claude-code-slash-commands-guide branch October 25, 2025 06:15
@p-iknow p-iknow moved this to Done in oss-kit-project Oct 25, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent Agent rules and commands

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

agent: update all custom commands to follow Claude Code slash commands guide

1 participant