Skip to content

feat(agent): auto discovery for claude skills & ci check #128

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Besthope-Official merged 2 commits into from
Feb 8, 2026
Merged

feat(agent): auto discovery for claude skills & ci check #128

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b8df5ea
feat: update Claude Compatibility Bridge section
Besthope-Official Feb 8, 2026
1158766
feat: add agent rules sync step to CI workflow
Besthope-Official Feb 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .clinerules
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ This file provides guidance to any coding agent when working with code in this r

[@CONTRIBUTIONS.md](/CONTRIBUTIONS.md)

## Discovery
- Skills live in `.claude/skills/*/SKILL.md` and should be loaded only on demand.
- Agents live in `.claude/agents/*.md` and should be used when task intent matches.
- Command templates live in `.claude/commands/*.md` and should be fetched when needed.

## Output Rules (Most Important)

### Prohibited Unnecessary Output
Expand Down
5 changes: 5 additions & 0 deletions .cursorrules
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ This file provides guidance to any coding agent when working with code in this r

[@CONTRIBUTIONS.md](/CONTRIBUTIONS.md)

## Discovery
- Skills live in `.claude/skills/*/SKILL.md` and should be loaded only on demand.
- Agents live in `.claude/agents/*.md` and should be used when task intent matches.
- Command templates live in `.claude/commands/*.md` and should be fetched when needed.

## Output Rules (Most Important)

### Prohibited Unnecessary Output
Expand Down
5 changes: 5 additions & 0 deletions .github/copilot-instructions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ This file provides guidance to any coding agent when working with code in this r

[@CONTRIBUTIONS.md](/CONTRIBUTIONS.md)

## Discovery
- Skills live in `.claude/skills/*/SKILL.md` and should be loaded only on demand.
- Agents live in `.claude/agents/*.md` and should be used when task intent matches.
- Command templates live in `.claude/commands/*.md` and should be fetched when needed.

## Output Rules (Most Important)

### Prohibited Unnecessary Output
Expand Down
3 changes: 3 additions & 0 deletions .github/workflows/ci.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,9 @@ jobs:
- name: Sync dependencies
run: uv sync --dev

- name: Agent rules synced
run: uv run --frozen scripts/agent_rules.py check

- name: Ruff check
run: uv run --frozen ruff check .

Expand Down
5 changes: 5 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ This file provides guidance to any coding agent when working with code in this r

[@CONTRIBUTIONS.md](/CONTRIBUTIONS.md)

## Discovery
- Skills live in `.claude/skills/*/SKILL.md` and should be loaded only on demand.
- Agents live in `.claude/agents/*.md` and should be used when task intent matches.
- Command templates live in `.claude/commands/*.md` and should be fetched when needed.

## Output Rules (Most Important)

### Prohibited Unnecessary Output
Expand Down
5 changes: 4 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,8 @@ For Claude Code, configure agent behaviors in `.claude/` directory:
- **Commands** (`.claude/commands/*.md`) - Slash commands for subagents: `/review`, `/plan`, `/refactor`, `/tdd`
- **Subagents** (`.claude/agents/*.md`) - Specialized agents for code review, planning, refactoring

Built-in slash commands and automatic skill discovery in `.claude/*` are currently Claude Code-only behaviors.

Inspired by [everything-claude-code](https://github.com/affaan-m/everything-claude-code), few patterns were summarized to help you better utilize Claude for coding a backend project.

### Backend
Expand Down Expand Up @@ -117,7 +119,6 @@ The compose files read environment variables from the repository root `.env` fil

This repo keeps a single source of truth for agent rules in `AGENTS.md`, and syncs it to:

- `CLAUDE.md`
- `.clinerules`
- `.cursorrules`
- `.github/copilot-instructions.md`
Expand All @@ -130,6 +131,8 @@ just agent-rules-sync

The `pre-commit` hook `agent-rules` runs the same check on commit.

For Codex, Cline, Cursor, and GitHub Copilot, `.claude` slash-command execution and skill auto-discovery are not built-in.

## Usage Examples

### Structured Logging
Expand Down
Loading