faostat-skills 0.2.1 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -6
- package/package.json +1 -2
- package/skills/analytical-brief/SKILL.md +1 -1
- package/skills/climate/SKILL.md +1 -1
- package/skills/commodity/SKILL.md +1 -1
- package/skills/compare/SKILL.md +1 -1
- package/skills/country-profile/SKILL.md +1 -1
- package/skills/explore/SKILL.md +1 -1
- package/skills/map/SKILL.md +1 -1
- package/skills/scientific-paper/SKILL.md +1 -1
- package/skills/story/SKILL.md +1 -1
- package/skills/trade/SKILL.md +1 -1
- package/skills/trends/SKILL.md +1 -1
- package/skills/viz/SKILL.md +1 -1
- /package/{marketplace.json → .claude-plugin/marketplace.json} +0 -0
package/README.md
CHANGED
|
@@ -22,10 +22,12 @@ claude plugin install faostat-skills@faostat
|
|
|
22
22
|
|
|
23
23
|
**OpenAI Codex**
|
|
24
24
|
```bash
|
|
25
|
-
|
|
25
|
+
# Clone, then copy each skill folder directly into your skills directory
|
|
26
|
+
git clone https://github.com/berba-q/faostat-skills.git /tmp/faostat-skills
|
|
27
|
+
cp -r /tmp/faostat-skills/skills/* ~/.codex/skills/
|
|
26
28
|
```
|
|
27
29
|
|
|
28
|
-
**Other AI assistants** — copy the `skills/` directory to wherever your tool discovers skill files. Consult your provider's documentation for the correct skills directory path.
|
|
30
|
+
**Other AI assistants** — copy the contents of the `skills/` directory to wherever your tool discovers skill files. Consult your provider's documentation for the correct skills directory path.
|
|
29
31
|
|
|
30
32
|
Once installed, try asking:
|
|
31
33
|
```
|
|
@@ -66,18 +68,24 @@ claude plugin update faostat-skills@faostat
|
|
|
66
68
|
|
|
67
69
|
### OpenAI Codex
|
|
68
70
|
|
|
69
|
-
|
|
71
|
+
Each skill folder must sit directly inside your Codex skills directory — not nested inside a parent folder. Clone and copy:
|
|
70
72
|
|
|
71
73
|
```bash
|
|
72
|
-
git clone https://github.com/berba-q/faostat-skills.git
|
|
74
|
+
git clone https://github.com/berba-q/faostat-skills.git /tmp/faostat-skills
|
|
75
|
+
cp -r /tmp/faostat-skills/skills/* ~/.codex/skills/
|
|
73
76
|
```
|
|
74
77
|
|
|
75
|
-
Or
|
|
78
|
+
Or keep the repo for easy updates via `git pull`:
|
|
76
79
|
|
|
77
80
|
```bash
|
|
78
|
-
|
|
81
|
+
git clone https://github.com/berba-q/faostat-skills.git ~/faostat-skills
|
|
82
|
+
for dir in ~/faostat-skills/skills/*/; do
|
|
83
|
+
ln -s "$dir" ~/.codex/skills/"$(basename "$dir")"
|
|
84
|
+
done
|
|
79
85
|
```
|
|
80
86
|
|
|
87
|
+
> Consult the [Codex documentation](https://platform.openai.com/docs/codex) for the exact skills directory path on your system.
|
|
88
|
+
|
|
81
89
|
### Other AI Assistants
|
|
82
90
|
|
|
83
91
|
Copy the `skills/` directory to wherever your AI tool discovers skill files. Each skill is a self-contained `SKILL.md` with YAML frontmatter and markdown instructions.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "faostat-skills",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.2",
|
|
4
4
|
"description": "Analysis skills for UN FAOSTAT food and agriculture data. Country profiles, commodity briefings, trade analysis, climate assessments, and data visualizations.",
|
|
5
5
|
"author": "Griffiths Obli-Laryea",
|
|
6
6
|
"license": "MIT",
|
|
@@ -28,7 +28,6 @@
|
|
|
28
28
|
"skills/",
|
|
29
29
|
"commands/",
|
|
30
30
|
".claude-plugin/",
|
|
31
|
-
"marketplace.json",
|
|
32
31
|
"README.md",
|
|
33
32
|
"LICENSE"
|
|
34
33
|
]
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-analytical-brief
|
|
3
|
-
description: Use when the user wants a short, FAOSTAT-style analytical brief — a multi-page PDF policy document in the FAOSTAT house visual style, with a HIGHLIGHTS box, global/regional/country sections, numbered figures with source lines, explanatory notes, and a data appendix. Use when the user asks for "an analytical brief on X", "a FAOSTAT-style brief", "a policy brief", "a FAO-style write-up", or a short policymaker-facing report. Keywords
|
|
3
|
+
description: Use when the user wants a short, FAOSTAT-style analytical brief — a multi-page PDF policy document in the FAOSTAT house visual style, with a HIGHLIGHTS box, global/regional/country sections, numbered figures with source lines, explanatory notes, and a data appendix. Use when the user asks for "an analytical brief on X", "a FAOSTAT-style brief", "a policy brief", "a FAO-style write-up", or a short policymaker-facing report. Keywords — analytical brief, policy brief, FAOSTAT brief, FAO-style, brief, briefing (policy), policymakers, short report (policy). Do NOT use for journalistic long-reads (use `faostat-story`), academic papers (forthcoming `faostat-scientific-paper`), or single-page visual summaries (forthcoming `faostat-infographic`).
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# FAOSTAT Analytical Brief
|
package/skills/climate/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-climate
|
|
3
|
-
description: Use when the user asks about agricultural emissions, climate impact of farming, agrifood carbon footprint, greenhouse gases from agriculture, deforestation, forest carbon sinks, temperature change, fertilizer emissions, N2O, land use change, emissions intensity, or the climate-agriculture nexus. Keywords
|
|
3
|
+
description: Use when the user asks about agricultural emissions, climate impact of farming, agrifood carbon footprint, greenhouse gases from agriculture, deforestation, forest carbon sinks, temperature change, fertilizer emissions, N2O, land use change, emissions intensity, or the climate-agriculture nexus. Keywords — emissions, climate, carbon, greenhouse gas, GHG, deforestation, forest, temperature, warming, N2O, fertilizer emissions, land use, agrifood, emissions intensity, carbon sink. Do NOT use for a full country food security profile → `faostat-country-profile`. Do NOT use for trend ranking across commodities or countries → `faostat-trends`.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Agrifood Climate Analyzer
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-commodity
|
|
3
|
-
description: Use when the user asks about a specific crop or commodity — global production, top producers, yield trends, trade flows, or a commodity briefing. Keywords
|
|
3
|
+
description: Use when the user asks about a specific crop or commodity — global production, top producers, yield trends, trade flows, or a commodity briefing. Keywords — commodity, crop, wheat, rice, maize, coffee, cocoa, soybean, sugar, cotton, palm oil, production rankings, top producers, yield, trade, global supply, briefing, deep dive. Do NOT use for side-by-side entity comparison → `faostat-compare`. Do NOT use for a country food security profile → `faostat-country-profile`. Do NOT use for trend ranking across commodities → `faostat-trends`.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Commodity Deep Dive
|
package/skills/compare/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-compare
|
|
3
|
-
description: Use ONLY when the user explicitly asks to compare two or more specific named entities (countries, commodities, or regions) side by side. Keywords
|
|
3
|
+
description: Use ONLY when the user explicitly asks to compare two or more specific named entities (countries, commodities, or regions) side by side. Keywords — compare, comparison, versus, vs, benchmark, countries, crops, production, yield, area harvested, trade, growth rate. Do NOT use for a global commodity briefing → `faostat-commodity`. Do NOT use for a country food security profile → `faostat-country-profile`. Do NOT use for trend ranking (fastest growing/declining) → `faostat-trends`. Do NOT use for import dependency or supply chain risk → `faostat-trade`.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Comparative Agricultural Analysis
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-country-profile
|
|
3
|
-
description: Use when the user asks for a food security profile, country agricultural overview, country hunger or nutrition assessment, or food system summary for a specific country. Keywords
|
|
3
|
+
description: Use when the user asks for a food security profile, country agricultural overview, country hunger or nutrition assessment, or food system summary for a specific country. Keywords — country profile, food security, undernourishment, production, trade, nutrition, calorie supply, dietary energy. Do NOT use for import dependence and supply chain risk → `faostat-trade`. Do NOT use for a global commodity briefing → `faostat-commodity`. Do NOT use for side-by-side country comparison → `faostat-compare`.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Country Food Security Profile
|
package/skills/explore/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-explore
|
|
3
|
-
description: Use when the user wants to discover what data is available in FAOSTAT, browse domains, understand what a domain contains, or is new to FAOSTAT and wants a guided tour. Use when the user mentions a topic and wants to know what FAOSTAT data covers it. Keywords
|
|
3
|
+
description: Use when the user wants to discover what data is available in FAOSTAT, browse domains, understand what a domain contains, or is new to FAOSTAT and wants a guided tour. Use when the user mentions a topic and wants to know what FAOSTAT data covers it. Keywords — explore, discover, browse, what data, available, domains, catalog, tour, overview, what can I find, show me, help me understand, new to FAOSTAT, getting started
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# FAOSTAT Explorer
|
package/skills/map/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-map
|
|
3
|
-
description: Use when the user wants a world or regional choropleth map of a FAOSTAT metric — production, yield, trade flow, emissions, temperature change, fertilizer use, undernourishment, or any other country-level indicator. Use when the user asks for "a map of X", "where is Y grown/produced/emitted", "show global distribution of Z", or for a choropleth / heat-map style visualization of FAOSTAT data. Keywords
|
|
3
|
+
description: Use when the user wants a world or regional choropleth map of a FAOSTAT metric — production, yield, trade flow, emissions, temperature change, fertilizer use, undernourishment, or any other country-level indicator. Use when the user asks for "a map of X", "where is Y grown/produced/emitted", "show global distribution of Z", or for a choropleth / heat-map style visualization of FAOSTAT data. Keywords — map, choropleth, world map, global distribution, country map, geographic, geospatial, heatmap, where, by country
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# FAOSTAT Choropleth Map
|
|
@@ -113,7 +113,7 @@ Write in this order. Do not skip ahead — Abstract last, Conclusion second-to-l
|
|
|
113
113
|
- Title (≤ 15 words, includes the outcome, the domain, and the time window)
|
|
114
114
|
- Author block (name, affiliation, email)
|
|
115
115
|
- Running head
|
|
116
|
-
- Keywords
|
|
116
|
+
- Keywords — 4–6, include "FAOSTAT"
|
|
117
117
|
- Data availability statement (points to the xlsx appendix and to FAOSTAT)
|
|
118
118
|
|
|
119
119
|
#### Introduction (≤ 800 words)
|
package/skills/story/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-story
|
|
3
|
-
description: Use when the user wants to build a data-driven narrative or article from FAOSTAT data for journalists, researchers, or general-audience communicators. Use when the user provides a research question, story angle, or topic they want to explore as an HTML data story with embedded interactive charts. Keywords
|
|
3
|
+
description: Use when the user wants to build a data-driven narrative or article from FAOSTAT data for journalists, researchers, or general-audience communicators. Use when the user provides a research question, story angle, or topic they want to explore as an HTML data story with embedded interactive charts. Keywords — story, narrative, article, journalism, data story, investigation, angle, headline, write-up, explainer, data journalism, long-read. Do NOT use when the user asks for an "analytical brief", "policy brief", "FAOSTAT brief", or a PDF policymaker-facing document — route to `faostat-analytical-brief` instead. Do NOT use for academic/scientific papers or single-page infographics.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Data Storyteller
|
package/skills/trade/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-trade
|
|
3
|
-
description: Use when the user asks about food import dependence, self-sufficiency ratio, supply chain risk, trade partners, trade concentration, food security vulnerability, import reliance, export dependence, or whether a country can feed itself for a specific commodity. Keywords
|
|
3
|
+
description: Use when the user asks about food import dependence, self-sufficiency ratio, supply chain risk, trade partners, trade concentration, food security vulnerability, import reliance, export dependence, or whether a country can feed itself for a specific commodity. Keywords — import, export, trade, self-sufficiency, dependency, supply chain, food security, trade partners, concentration risk, import reliance, vulnerability. Do NOT use for a comprehensive country food security profile → `faostat-country-profile`. Do NOT use for a global commodity briefing → `faostat-commodity`. Do NOT use for side-by-side country comparison → `faostat-compare`.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Trade Dependency Analyzer
|
package/skills/trends/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-trends
|
|
3
|
-
description: Use when the user wants to identify biggest changes, fastest-growing or declining agricultural productions, or anomalies in FAOSTAT data over a time window for a region or set of countries. Keywords
|
|
3
|
+
description: Use when the user wants to identify biggest changes, fastest-growing or declining agricultural productions, or anomalies in FAOSTAT data over a time window for a region or set of countries. Keywords — trends, growth, decline, anomaly, change, biggest movers, acceleration, deceleration, monitoring, shift, surge, drop, spike. Do NOT use for a global commodity briefing → `faostat-commodity`. Do NOT use for a country food security profile → `faostat-country-profile`. Do NOT use for side-by-side comparison → `faostat-compare`.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Agricultural Trend Monitor
|
package/skills/viz/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: faostat-viz
|
|
3
|
-
description: Use when the user asks to visualize, chart, graph, or plot FAOSTAT data, or when they want a visual representation of agricultural statistics. Also use when another skill needs to produce a chart. Keywords
|
|
3
|
+
description: Use when the user asks to visualize, chart, graph, or plot FAOSTAT data, or when they want a visual representation of agricultural statistics. Also use when another skill needs to produce a chart. Keywords — chart, graph, plot, visualize, visualization, bar chart, line chart, scatter plot, stacked bar, HTML, interactive, Chart.js, trend chart, comparison chart. Do NOT use when the user wants a shareable, public-facing one-pager or social graphic → use `faostat-infographic`. Do NOT use when the user wants a full narrative report with charts → use `faostat-story` or `faostat-analytical-brief`.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# FAOSTAT Data Visualizer
|
|
File without changes
|