Skip to content

docs(ai): update Claude Code instructions for skill discovery and usage #6421

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

Closed
zdrawku wants to merge 5 commits into from
Closed

docs(ai): update Claude Code instructions for skill discovery and usage #6421

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
12aad7f
docs(ai): update Claude Code instructions for skill discovery and usage
zdrawku Mar 20, 2026
7d46d0a
fix(skills): correcting ide info
ChronosSF Mar 23, 2026
6135419
fix(ci): adding frontmatter and backmatter to cspell
ChronosSF Mar 23, 2026
32add47
Merge branch 'vnext' into zkolev/addressing-feedback
ChronosSF Mar 23, 2026
33ce684
Merge branch 'vnext' into zkolev/addressing-feedback
kdinev Apr 1, 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
4 changes: 3 additions & 1 deletion cspell.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -260,6 +260,8 @@
"batchediting",
"updateparameters",
"alldata",
"subtag"
"subtag",
"frontmatter",
"backmatter"
]
}
49 changes: 28 additions & 21 deletions en/components/ai/skills.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,13 +44,13 @@ GitHub Copilot reads custom instructions from a `.github/copilot-instructions.md
```

3. Alternatively, paste the full content of the relevant `SKILL.md` files directly into `copilot-instructions.md` for fully offline, self-contained instructions.
4. Copilot will now apply these instructions automatically on every chat and inline suggestion in VS Code.
4. Copilot will now apply these instructions automatically on every Copilot Chat request in VS Code.
Copy link

Copilot AI Apr 1, 2026

Choose a reason for hiding this comment

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

The repo’s JP docs are expected to mirror EN structure/content (see .github/workflows/sync-jp-docs.md where ./jp/ “must mirror ./en/). This section was updated in EN to say instructions apply to “every Copilot Chat request”, but the JP counterpart still says “chat and inline suggestions”. Please sync the JP page (or adjust EN) so both locales describe the same behavior.

Suggested change
4. Copilot will now apply these instructions automatically on every Copilot Chat request in VS Code.
4. Copilot will now apply these instructions automatically for chat and inline suggestions in VS Code.

Copilot uses AI. Check for mistakes.

### Cursor

Cursor supports persistent project rules through a `.cursorrules` file or the `.cursor/rules/` directory:
Cursor supports persistent project rules through the `.cursor/rules/` directory:

1. Create `.cursorrules` in your project root (or `.cursor/rules/igniteui.md` for a named rule).
1. Create `.cursor/rules/igniteui.md` in your project root.
Comment on lines +51 to +53
Copy link
Copy Markdown
Member

@damyanpetev damyanpetev Mar 23, 2026

Choose a reason for hiding this comment

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

That's instructions for https://cursor.com/docs/rules instead of https://cursor.com/docs/skills#skill-directories too, as a matter of fact all of the editor options besides the General AI Agents and the now updated Claude are like that

2. Paste the contents of the desired `SKILL.md` files into that file. For example:
Comment on lines +51 to 54
Copy link

Copilot AI Apr 1, 2026

Choose a reason for hiding this comment

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

The repo’s JP docs are expected to mirror EN (per .github/workflows/sync-jp-docs.md). EN updated multiple agent sections here (Cursor/Windsurf/JetBrains/Claude Code), but the JP version still contains the older instructions for those sections. Please sync jp/components/ai/skills.md to match the updated EN guidance to avoid diverging setup steps between locales.

Copilot uses AI. Check for mistakes.

```
Expand All @@ -60,40 +60,47 @@ Cursor supports persistent project rules through a `.cursorrules` file or the `.
<paste contents of skills/igniteui-angular-grids/SKILL.md here>
```

3. Cursor will include these rules in every AI request automatically. You can also use the `@rules` mention in chat to reference a specific rule on demand.
3. Cursor will include these rules in every AI request automatically. You can also @mention the rule by name in chat (e.g., `@igniteui`) to reference it on demand.

### Windsurf

Windsurf reads persistent rules from a `.windsurfrules` file at the project root:
Windsurf supports persistent rules stored as Markdown files in the `.windsurf/rules/` directory of your project:

1. Create `.windsurfrules` in your project root.
2. Paste the contents of the relevant `SKILL.md` files into it.
1. Create a `.windsurf/rules/` directory in your project root.
2. Create a rule file, for example `.windsurf/rules/igniteui.md`, and paste the contents of the relevant `SKILL.md` files into it.
3. Every Cascade AI session in Windsurf will now include these as persistent instructions.

> **Tip:** You can also define global rules (applied across all workspaces) by editing `~/.codeium/windsurf/memories/global_rules.md`.

### JetBrains IDEs (WebStorm, IntelliJ)

JetBrains AI Assistant supports project-level prompts that are applied to every AI interaction:
JetBrains AI Assistant supports project-level rules stored as Markdown files that are applied to every AI interaction:

1. Open **Settings** (or **Preferences** on macOS) → **Tools** → **AI Assistant** → **Project-level prompt**.
2. Paste the contents of the relevant `SKILL.md` files into the prompt field.
3. Click **Apply**. The AI Assistant will now follow these instructions for all requests inside the project.
1. Open **Settings** → **Tools** → **AI Assistant** → **Rules**.
2. Click **New Project Rules File**, provide a name (e.g., `igniteui`), and confirm. This creates a `.aiassistant/rules/igniteui.md` file in your project root.
3. Paste the contents of the relevant `SKILL.md` files into that file and save it. The AI Assistant will now follow these rules for all requests inside the project.

### Claude Code

Claude Code supports a `CLAUDE.md` file at the project root as persistent agent instructions:

1. Create `CLAUDE.md` in your project root.
2. Paste the contents of the relevant `SKILL.md` files into it. For example:
Claude Code loads skills from `.claude/skills/` at both project and user level. Each skill's `description` field in its `SKILL.md` frontmatter tells Claude when to invoke it automatically. You can also invoke any skill directly with `/skill-name`.

Comment on lines +85 to 86
Copy link

Copilot AI Apr 1, 2026

Choose a reason for hiding this comment

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

This introduces /skill-name as a direct invocation syntax, but the following step uses a concrete example (/igniteui-angular-grids). To reduce ambiguity, consider either documenting the exact invocation format Claude Code expects (with one consistent example) or removing the placeholder /skill-name wording.

Copilot uses AI. Check for mistakes.
```markdown
# Project Instructions
1. Create a `.claude/skills/` directory in your project root.
2. Copy the skill directories from the `igniteui-angular/skills/` repository into `.claude/skills/`:
Copy link

Copilot AI Apr 1, 2026

Choose a reason for hiding this comment

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

Wording issue: igniteui-angular/skills/ is a directory path inside the igniteui-angular repository, not a repository itself. Consider rephrasing to “from the igniteui-angular repository’s skills/ directory” to avoid sending readers to a nonexistent repo.

Suggested change
2. Copy the skill directories from the `igniteui-angular/skills/` repository into `.claude/skills/`:
2. Copy the skill directories from the `igniteui-angular` repository's `skills/` directory into `.claude/skills/`:

Copilot uses AI. Check for mistakes.

This project uses Ignite UI for Angular. Always follow these guidelines:

<paste contents of SKILL.md files here>
```
.claude/
skills/
igniteui-angular-components/
SKILL.md
igniteui-angular-grids/
SKILL.md
igniteui-angular-theming/
SKILL.md
```

3. Claude Code will load the relevant skill automatically when your request matches its description, or you can invoke it directly (e.g., `/igniteui-angular-grids`).

3. Claude Code will automatically read `CLAUDE.md` at the start of every session.
> **Tip:** You can also install skills globally under `~/.claude/skills/` so they are available across all projects.

### General AI Agents

Expand Down
25 changes: 15 additions & 10 deletions jp/components/ai/skills.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,20 +81,25 @@ JetBrains AI Assistant は、すべての AI インタラクションに適用

### Claude Code

Claude Code は、プロジェクト ルートにある `CLAUDE.md` ファイルを永続的なエージェント指示としてサポートします。
Claude Code は、プロジェクト レベルおよびユーザー レベルの `.claude/skills/` ディレクトリからスキルを検出します。

1. プロジェクト ルートに `CLAUDE.md` を作成します。
2. 関連する `SKILL.md` ファイルの内容を貼り付けます。例:
1. プロジェクト ルートに `.claude/skills/` ディレクトリを作成します。
2. `igniteui-angular/skills/` リポジトリからスキル ディレクトリを `.claude/skills/` にコピーします。
Copy link

Copilot AI Apr 1, 2026

Choose a reason for hiding this comment

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

Wording issue: igniteui-angular/skills/ is a directory in the igniteui-angular repository, not a repository itself. Please rephrase so Japanese readers aren’t led to look for a nonexistent “skills repo” (e.g., “igniteui-angular リポジトリの skills/ ディレクトリから…”).

Suggested change
2. `igniteui-angular/skills/` リポジトリからスキル ディレクトリを `.claude/skills/` にコピーします。
2. `igniteui-angular` リポジトリの `skills/` ディレクトリからスキル ディレクトリを `.claude/skills/` にコピーします。

Copilot uses AI. Check for mistakes.

Comment on lines +84 to 88
Copy link

Copilot AI Apr 1, 2026

Choose a reason for hiding this comment

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

EN’s Claude Code section now adds details about how skills are selected (based on SKILL.md frontmatter description) and mentions direct invocation (e.g., /igniteui-angular-grids). The JP Claude Code section doesn’t include these details, which breaks the EN↔JP mirroring requirement stated in .github/workflows/sync-jp-docs.md (JP “must mirror EN”). Please sync the JP Claude Code content with the updated EN section.

Copilot uses AI. Check for mistakes.
```markdown
# Project Instructions

This project uses Ignite UI for Angular. Always follow these guidelines:

<paste contents of SKILL.md files here>
```
.claude/
skills/
igniteui-angular-components/
SKILL.md
igniteui-angular-grids/
SKILL.md
igniteui-angular-theming/
SKILL.md
```

3. Claude Code はコンテキストに基づいて、関連するスキルを自動的に検出して適用します。

3. Claude Code はすべてのセッション開始時に `CLAUDE.md` を自動的に読み込むようになります。
> **ヒント:** `~/.claude/skills/` にスキルをグローバルにインストールすると、すべてのプロジェクトで利用可能になります。

### 一般的な AI エージェント

Expand Down
Loading