gilles/claude-code-best-practice
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[how to use][how to implement]

Browse Source
This commit is contained in:
Shayan Rais
2026-03-02 14:25:26 +05:00
parent 182ca334f0
commit 91c3c149c4
9 changed files with 102 additions and 55 deletions
Download Patch File Download Diff File Expand all files Collapse all files
implementation/claude-commands-implementation.md
+7 -1
View File
@@ -53,7 +53,7 @@ The command orchestrates the entire workflow: it asks the user for their tempera
---
## How to Use
## ![How to Use](../!/tags/how-to-use.svg)
```bash
$ claude
@@ -62,6 +62,12 @@ $ claude
---
## ![How to Implement](../!/tags/how-to-implement.svg)
Ask Claude to create one for you — it will generate the markdown file with YAML frontmatter and body in `.claude/commands/<name>.md`
---
<a href="https://github.com/shanraisshan/claude-code-best-practice#orchestration-workflow"><img src="../!/tags/orchestration-workflow-hd.svg" alt="Orchestration Workflow"></a>
The weather orchestrator is the **Command** in the Command → Agent → Skill orchestration pattern. It serves as the entry point — handling user interaction (temperature unit preference), delegating data fetching to the `weather-agent`, and invoking the `weather-svg-creator` skill for visual output.
implementation/claude-skills-implementation.md
+6 -20
View File
@@ -99,7 +99,7 @@ This is an **agent skill** — preloaded into the `weather-agent` at startup via
---
## How to Use
## ![How to Use](../!/tags/how-to-use.svg)
**Skill** — invoke directly via slash command:
```bash
@@ -107,27 +107,13 @@ $ claude
> /weather-svg-creator
```
**Agent Skill** — not directly invocable (`user-invocable: false`). Preloaded into the agent via `skills:` frontmatter:
```yaml
# In .claude/agents/weather-agent.md
---
skills:
- weather-fetcher
---
```
---
<a href="https://github.com/shanraisshan/claude-code-best-practice#orchestration-workflow"><img src="../!/tags/orchestration-workflow-hd.svg" alt="Orchestration Workflow"></a>
## ![How to Implement](../!/tags/how-to-implement.svg)
The skills are the final components in the Command → Agent → Skill orchestration pattern. The `weather-fetcher` is preloaded into the `weather-agent` as domain knowledge for API interaction, while the `weather-svg-creator` is invoked directly by the command to transform the fetched data into visual output.
Ask Claude to create one for you — it will generate the markdown file with YAML frontmatter and body in `.claude/skills/my-skill/SKILL.md`
<p align="center">
<img src="../!/command-skill-agent-flow.svg" alt="Command Skill Agent Architecture Flow" width="100%">
</p>
# My Skill
| Component | Role | This Repo |
|-----------|------|-----------|
| **Command** | Entry point, user interaction | [`/weather-orchestrator`](../.claude/commands/weather-orchestrator.md) |
| **Agent** | Fetches data with preloaded skill (agent skill) | [`weather-agent`](../.claude/agents/weather-agent.md) with [`weather-fetcher`](../.claude/skills/weather-fetcher/SKILL.md) |
| **Skill** | Creates output independently (skill) | [`weather-svg-creator`](../.claude/skills/weather-svg-creator/SKILL.md) |
Instructions for what the skill does.
```
implementation/claude-subagents-implementation.md
+13 -1
View File
@@ -58,7 +58,7 @@ The agent has one preloaded skill (`weather-fetcher`) that provides instructions
---
## How to Use
## ![How to Use](../!/tags/how-to-use.svg)
```bash
$ claude
@@ -67,6 +67,18 @@ $ claude
---
## ![How to Implement](../!/tags/how-to-implement.svg)
You can create an agent using the `/agents` command,
```bash
$ claude
> /agents
```
or ask Claude to create one for you — it will generate the markdown file with YAML frontmatter and body in `.claude/agents/<name>.md`
---
<a href="https://github.com/shanraisshan/claude-code-best-practice#orchestration-workflow"><img src="../!/tags/orchestration-workflow-hd.svg" alt="Orchestration Workflow"></a>
The weather agent is the **Agent** in the Command → Agent → Skill orchestration pattern. It receives the workflow from the `/weather-orchestrator` command and fetches temperature using its preloaded skill (`weather-fetcher`). The command then invokes the standalone `weather-svg-creator` skill to create the visual output.