Skip to content

Align SKILL.md read_skill_resource examples with actual skill IDs #22

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
aravindh28 merged 2 commits into from
Mar 3, 2026
Merged

Align SKILL.md read_skill_resource examples with actual skill IDs #22

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
169b794
Initial plan
Copilot Mar 3, 2026
074c429
Fix skill markdown example names to match skill IDs
Copilot Mar 3, 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
12 changes: 6 additions & 6 deletions src/skills/california-schools-semantic-model/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@ when you need deeper detail beyond what is in this file.

| Resource | What it contains | How to load |
|---|---|---|
| Extended gotchas | Edge cases, NULL handling details, type pitfalls | `read_skill_resource("california-schools-template-semantic-model", "references/gotchas.md")` |
| Metric definitions | Full formulas for FRPM rate, SAT composite, etc. | `read_skill_resource("california-schools-template-semantic-model", "references/metrics.md")` |
| Query patterns | Canonical SQL for common questions (top schools, county stats, etc.) | `read_skill_resource("california-schools-template-semantic-model", "references/query_patterns.md")` |
| Extended gotchas | Edge cases, NULL handling details, type pitfalls | `read_skill_resource("california-schools-semantic-model", "references/gotchas.md")` |
| Metric definitions | Full formulas for FRPM rate, SAT composite, etc. | `read_skill_resource("california-schools-semantic-model", "references/metrics.md")` |
| Query patterns | Canonical SQL for common questions (top schools, county stats, etc.) | `read_skill_resource("california-schools-semantic-model", "references/query_patterns.md")` |

**When to load resources:**
- If you are unsure about a metric formula → load `references/metrics.md`
Expand Down Expand Up @@ -65,7 +65,7 @@ when you need deeper detail beyond what is in this file.
For extended gotchas and edge cases, call:
```python
read_skill_resource(
skill_name="california-schools-template-semantic-model",
skill_name="california-schools-semantic-model",
resource_name="references/gotchas.md"
)
```
Expand All @@ -84,7 +84,7 @@ There is no direct join between `frpm` and `satscores`; always go through `schoo
For canonical query patterns (top schools by SAT score, FRPM rate by county, etc.), call:
```python
read_skill_resource(
skill_name="california-schools-template-semantic-model",
skill_name="california-schools-semantic-model",
resource_name="references/query_patterns.md"
)
```
Expand All @@ -94,7 +94,7 @@ read_skill_resource(
For full metric formulas and calculation details, call:
```python
read_skill_resource(
skill_name="california-schools-template-semantic-model",
skill_name="california-schools-semantic-model",
resource_name="references/metrics.md"
)
```
12 changes: 6 additions & 6 deletions src/skills/debit-card-specializing-semantic-model/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@ metadata:

| Resource | What it contains | How to load |
|---|---|---|
| Extended gotchas | YYYYMM date format, Czech product names, country codes, segment values | `read_skill_resource("debit-card-semantic-model", "references/gotchas.md")` |
| Metric definitions | Spend per customer, monthly consumption, station-level aggregates | `read_skill_resource("debit-card-semantic-model", "references/metrics.md")` |
| Query patterns | Canonical SQL for customer spend, station queries, product filtering | `read_skill_resource("debit-card-semantic-model", "references/query_patterns.md")` |
| Extended gotchas | YYYYMM date format, Czech product names, country codes, segment values | `read_skill_resource("debit-card-specializing-semantic-model", "references/gotchas.md")` |
| Metric definitions | Spend per customer, monthly consumption, station-level aggregates | `read_skill_resource("debit-card-specializing-semantic-model", "references/metrics.md")` |
| Query patterns | Canonical SQL for customer spend, station queries, product filtering | `read_skill_resource("debit-card-specializing-semantic-model", "references/query_patterns.md")` |

**When to load resources:**
- If filtering by date or month → load `references/gotchas.md` (date is an integer, not a DATE column)
Expand Down Expand Up @@ -60,7 +60,7 @@ metadata:
For extended gotchas and SQL examples, call:
```python
read_skill_resource(
skill_name="debit-card-semantic-model",
skill_name="debit-card-specializing-semantic-model",
resource_name="references/gotchas.md"
)
```
Expand All @@ -83,7 +83,7 @@ For canonical query patterns (spend by segment, monthly trends, station country
breakdowns), call:
```python
read_skill_resource(
skill_name="debit-card-semantic-model",
skill_name="debit-card-specializing-semantic-model",
resource_name="references/query_patterns.md"
)
```
Expand All @@ -94,7 +94,7 @@ For full metric formulas (total spend, monthly consumption, station-level
aggregates), call:
```python
read_skill_resource(
skill_name="debit-card-semantic-model",
skill_name="debit-card-specializing-semantic-model",
resource_name="references/metrics.md"
)
```
12 changes: 6 additions & 6 deletions src/skills/european-football-2-semantic-model/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@ metadata:

| Resource | What it contains | How to load |
|---|---|---|
| Extended gotchas | API IDs vs primary keys, time-series attribute joins, home/away goal logic | `read_skill_resource("european-football-semantic-model", "references/gotchas.md")` |
| Metric definitions | Win rates, average goals per match, player ratings, form metrics | `read_skill_resource("european-football-semantic-model", "references/metrics.md")` |
| Query patterns | Team standings, top-rated players, head-to-head records | `read_skill_resource("european-football-semantic-model", "references/query_patterns.md")` |
| Extended gotchas | API IDs vs primary keys, time-series attribute joins, home/away goal logic | `read_skill_resource("european-football-2-semantic-model", "references/gotchas.md")` |
| Metric definitions | Win rates, average goals per match, player ratings, form metrics | `read_skill_resource("european-football-2-semantic-model", "references/metrics.md")` |
| Query patterns | Team standings, top-rated players, head-to-head records | `read_skill_resource("european-football-2-semantic-model", "references/query_patterns.md")` |

**When to load resources:**
- If joining teams or players to matches → load `references/gotchas.md` (API ID vs id is critical)
Expand Down Expand Up @@ -62,7 +62,7 @@ metadata:
For extended gotchas and SQL examples, call:
```python
read_skill_resource(
skill_name="european-football-semantic-model",
skill_name="european-football-2-semantic-model",
resource_name="references/gotchas.md"
)
```
Expand All @@ -88,7 +88,7 @@ For canonical query patterns (season standings, top scorers, player ratings),
call:
```python
read_skill_resource(
skill_name="european-football-semantic-model",
skill_name="european-football-2-semantic-model",
resource_name="references/query_patterns.md"
)
```
Expand All @@ -98,7 +98,7 @@ read_skill_resource(
For full metric formulas (goals per game, win rates, player rating trends), call:
```python
read_skill_resource(
skill_name="european-football-semantic-model",
skill_name="european-football-2-semantic-model",
resource_name="references/metrics.md"
)
```
12 changes: 6 additions & 6 deletions src/skills/formula-1-semantic-model/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@ metadata:

| Resource | What it contains | How to load |
|---|---|---|
| Extended gotchas | Time string vs milliseconds, NULL positions, positionText values, standings pitfalls | `read_skill_resource("formula1-semantic-model", "references/gotchas.md")` |
| Metric definitions | Points totals, win counts, pit stop averages, championship standings | `read_skill_resource("formula1-semantic-model", "references/metrics.md")` |
| Query patterns | Driver standings, constructor wins, fastest laps, DNF analysis | `read_skill_resource("formula1-semantic-model", "references/query_patterns.md")` |
| Extended gotchas | Time string vs milliseconds, NULL positions, positionText values, standings pitfalls | `read_skill_resource("formula-1-semantic-model", "references/gotchas.md")` |
| Metric definitions | Points totals, win counts, pit stop averages, championship standings | `read_skill_resource("formula-1-semantic-model", "references/metrics.md")` |
| Query patterns | Driver standings, constructor wins, fastest laps, DNF analysis | `read_skill_resource("formula-1-semantic-model", "references/query_patterns.md")` |

**When to load resources:**
- If the query involves timing or lap times → load `references/gotchas.md` (time columns are strings)
Expand Down Expand Up @@ -63,7 +63,7 @@ metadata:
For extended gotchas and SQL examples, call:
```python
read_skill_resource(
skill_name="formula1-semantic-model",
skill_name="formula-1-semantic-model",
resource_name="references/gotchas.md"
)
```
Expand All @@ -87,7 +87,7 @@ races.raceId ──→ constructorstandings.raceId
For canonical query patterns (season champions, win counts, fastest laps), call:
```python
read_skill_resource(
skill_name="formula1-semantic-model",
skill_name="formula-1-semantic-model",
resource_name="references/query_patterns.md"
)
```
Expand All @@ -98,7 +98,7 @@ For full metric formulas (points per season, pit stop averages, constructor wins
call:
```python
read_skill_resource(
skill_name="formula1-semantic-model",
skill_name="formula-1-semantic-model",
resource_name="references/metrics.md"
)
```