opencode-skills-collection 2.0.0-beta.3 → 2.0.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.
Files changed (91) hide show
  1. package/README.md +1 -0
  2. package/bundled-skills/.antigravity-install-manifest.json +6 -1
  3. package/bundled-skills/docs/integrations/jetski-cortex.md +3 -3
  4. package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md +1 -1
  5. package/bundled-skills/docs/maintainers/repo-growth-seo.md +3 -3
  6. package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
  7. package/bundled-skills/docs/users/bundles.md +1 -1
  8. package/bundled-skills/docs/users/claude-code-skills.md +1 -1
  9. package/bundled-skills/docs/users/gemini-cli-skills.md +1 -1
  10. package/bundled-skills/docs/users/getting-started.md +1 -1
  11. package/bundled-skills/docs/users/kiro-integration.md +1 -1
  12. package/bundled-skills/docs/users/usage.md +4 -4
  13. package/bundled-skills/docs/users/visual-guide.md +4 -4
  14. package/bundled-skills/manage-skills/SKILL.md +187 -0
  15. package/bundled-skills/monte-carlo-monitor-creation/SKILL.md +222 -0
  16. package/bundled-skills/monte-carlo-monitor-creation/references/comparison-monitor.md +426 -0
  17. package/bundled-skills/monte-carlo-monitor-creation/references/custom-sql-monitor.md +207 -0
  18. package/bundled-skills/monte-carlo-monitor-creation/references/metric-monitor.md +292 -0
  19. package/bundled-skills/monte-carlo-monitor-creation/references/table-monitor.md +231 -0
  20. package/bundled-skills/monte-carlo-monitor-creation/references/validation-monitor.md +404 -0
  21. package/bundled-skills/monte-carlo-prevent/SKILL.md +252 -0
  22. package/bundled-skills/monte-carlo-prevent/references/TROUBLESHOOTING.md +23 -0
  23. package/bundled-skills/monte-carlo-prevent/references/parameters.md +32 -0
  24. package/bundled-skills/monte-carlo-prevent/references/workflows.md +478 -0
  25. package/bundled-skills/monte-carlo-push-ingestion/SKILL.md +363 -0
  26. package/bundled-skills/monte-carlo-push-ingestion/references/anomaly-detection.md +87 -0
  27. package/bundled-skills/monte-carlo-push-ingestion/references/custom-lineage.md +203 -0
  28. package/bundled-skills/monte-carlo-push-ingestion/references/direct-http-api.md +207 -0
  29. package/bundled-skills/monte-carlo-push-ingestion/references/prerequisites.md +150 -0
  30. package/bundled-skills/monte-carlo-push-ingestion/references/push-lineage.md +160 -0
  31. package/bundled-skills/monte-carlo-push-ingestion/references/push-metadata.md +158 -0
  32. package/bundled-skills/monte-carlo-push-ingestion/references/push-query-logs.md +219 -0
  33. package/bundled-skills/monte-carlo-push-ingestion/references/validation.md +257 -0
  34. package/bundled-skills/monte-carlo-push-ingestion/scripts/sample_verify.py +357 -0
  35. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_and_push_lineage.py +70 -0
  36. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_and_push_metadata.py +65 -0
  37. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_and_push_query_logs.py +70 -0
  38. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_lineage.py +214 -0
  39. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_metadata.py +160 -0
  40. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_query_logs.py +164 -0
  41. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/push_lineage.py +198 -0
  42. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/push_metadata.py +193 -0
  43. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/push_query_logs.py +207 -0
  44. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_and_push_metadata.py +71 -0
  45. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_and_push_query_logs.py +64 -0
  46. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_metadata.py +253 -0
  47. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_query_logs.py +149 -0
  48. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/push_metadata.py +190 -0
  49. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/push_query_logs.py +208 -0
  50. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_and_push_lineage.py +83 -0
  51. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_and_push_metadata.py +77 -0
  52. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_and_push_query_logs.py +83 -0
  53. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_lineage.py +240 -0
  54. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_metadata.py +212 -0
  55. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_query_logs.py +204 -0
  56. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/push_lineage.py +192 -0
  57. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/push_metadata.py +178 -0
  58. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/push_query_logs.py +200 -0
  59. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_and_push_lineage.py +119 -0
  60. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_and_push_metadata.py +119 -0
  61. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_and_push_query_logs.py +117 -0
  62. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_lineage.py +265 -0
  63. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_metadata.py +313 -0
  64. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_query_logs.py +284 -0
  65. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/push_lineage.py +309 -0
  66. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/push_metadata.py +245 -0
  67. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/push_query_logs.py +255 -0
  68. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_and_push_lineage.py +78 -0
  69. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_and_push_metadata.py +80 -0
  70. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_and_push_query_logs.py +88 -0
  71. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_lineage.py +235 -0
  72. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_metadata.py +219 -0
  73. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_query_logs.py +239 -0
  74. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/push_lineage.py +178 -0
  75. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/push_metadata.py +178 -0
  76. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/push_query_logs.py +196 -0
  77. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_and_push_lineage.py +154 -0
  78. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_and_push_metadata.py +137 -0
  79. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_and_push_query_logs.py +137 -0
  80. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_lineage.py +349 -0
  81. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_metadata.py +329 -0
  82. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_query_logs.py +254 -0
  83. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/push_lineage.py +307 -0
  84. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/push_metadata.py +228 -0
  85. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/push_query_logs.py +248 -0
  86. package/bundled-skills/monte-carlo-push-ingestion/scripts/test_template_sdk_usage.py +340 -0
  87. package/bundled-skills/monte-carlo-validation-notebook/SKILL.md +685 -0
  88. package/bundled-skills/monte-carlo-validation-notebook/scripts/generate_notebook_url.py +141 -0
  89. package/bundled-skills/monte-carlo-validation-notebook/scripts/resolve_dbt_schema.py +161 -0
  90. package/package.json +1 -1
  91. package/skills_index.json +503 -61
package/README.md CHANGED
@@ -9,6 +9,7 @@
9
9
  [![npm version](https://img.shields.io/npm/v/opencode-skills-collection?style=for-the-badge&color=cb3837&label=npm)](https://www.npmjs.com/package/opencode-skills-collection)
10
10
  [![npm downloads](https://img.shields.io/npm/dm/opencode-skills-collection?style=for-the-badge&color=orange)](https://www.npmjs.com/package/opencode-skills-collection)
11
11
  [![license](https://img.shields.io/github/license/FrancoStino/opencode-skills-collection?style=for-the-badge&color=blue)](./LICENSE)
12
+ [![wiki](https://img.shields.io/badge/wiki-available-black?style=for-the-badge)](https://www.cubic.dev/wikis/FrancoStino/opencode-skills-collection?page=home)
12
13
 
13
14
  </div>
14
15
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "updatedAt": "2026-04-09T09:09:48.777Z",
3
+ "updatedAt": "2026-04-09T19:50:45.367Z",
4
4
  "entries": [
5
5
  "00-andruia-consultant",
6
6
  "007",
@@ -815,6 +815,7 @@
815
815
  "makepad-splash",
816
816
  "makepad-widgets",
817
817
  "malware-analyst",
818
+ "manage-skills",
818
819
  "manifest",
819
820
  "market-sizing-analysis",
820
821
  "marketing-ideas",
@@ -849,6 +850,10 @@
849
850
  "monetization",
850
851
  "monorepo-architect",
851
852
  "monorepo-management",
853
+ "monte-carlo-monitor-creation",
854
+ "monte-carlo-prevent",
855
+ "monte-carlo-push-ingestion",
856
+ "monte-carlo-validation-notebook",
852
857
  "moodle-external-api-development",
853
858
  "moyu",
854
859
  "mtls-configuration",
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  title: Jetski/Cortex + Gemini Integration Guide
3
- description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1.392+ skills."
3
+ description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1.397+ skills."
4
4
  ---
5
5
 
6
- # Jetski/Cortex + Gemini: safe integration with 1,1.392+ skills
6
+ # Jetski/Cortex + Gemini: safe integration with 1,1.397+ skills
7
7
 
8
8
  This guide shows how to integrate the `antigravity-awesome-skills` repository with an agent based on **Jetski/Cortex + Gemini** (or similar frameworks) **without exceeding the model context window**.
9
9
 
@@ -23,7 +23,7 @@ Never do:
23
23
  - concatenate all `SKILL.md` content into a single system prompt;
24
24
  - re-inject the entire library for **every** request.
25
25
 
26
- With over 1,1.392 skills, this approach fills the context window before user messages are even added, causing truncation.
26
+ With over 1,1.397 skills, this approach fills the context window before user messages are even added, causing truncation.
27
27
 
28
28
  ---
29
29
 
@@ -20,7 +20,7 @@ This example shows one way to integrate **antigravity-awesome-skills** with a Je
20
20
  - How to enforce a **maximum number of skills per turn** via `maxSkillsPerTurn`.
21
21
  - How to choose whether to **truncate or error** when too many skills are requested via `overflowBehavior`.
22
22
 
23
- This pattern avoids context overflow when you have 1,392+ skills installed.
23
+ This pattern avoids context overflow when you have 1,397+ skills installed.
24
24
 
25
25
  ---
26
26
 
@@ -6,7 +6,7 @@ This document keeps the repository's GitHub-facing discovery copy aligned with t
6
6
 
7
7
  Preferred positioning:
8
8
 
9
- > Installable GitHub library of 1,392+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.
9
+ > Installable GitHub library of 1,397+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.
10
10
 
11
11
  Key framing:
12
12
 
@@ -20,7 +20,7 @@ Key framing:
20
20
 
21
21
  Preferred description:
22
22
 
23
- > Installable GitHub library of 1,392+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
23
+ > Installable GitHub library of 1,397+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
24
24
 
25
25
  Preferred homepage:
26
26
 
@@ -28,7 +28,7 @@ Preferred homepage:
28
28
 
29
29
  Preferred social preview:
30
30
 
31
- - use a clean preview image that says `1,392+ Agentic Skills`;
31
+ - use a clean preview image that says `1,397+ Agentic Skills`;
32
32
  - mention Claude Code, Cursor, Codex CLI, and Gemini CLI;
33
33
  - avoid dense text and tiny logos that disappear in social cards.
34
34
 
@@ -69,7 +69,7 @@ For manual updates, you need:
69
69
  The update process refreshes:
70
70
  - Skills index (`skills_index.json`)
71
71
  - Web app skills data (`apps\web-app\public\skills.json`)
72
- - All 1,392+ skills from the skills directory
72
+ - All 1,397+ skills from the skills directory
73
73
 
74
74
  ## When to Update
75
75
 
@@ -673,4 +673,4 @@ Found a skill that should be in a bundle? Or want to create a new bundle? [Open
673
673
 
674
674
  ---
675
675
 
676
- _Last updated: March 2026 | Total Skills: 1,392+ | Total Bundles: 37_
676
+ _Last updated: March 2026 | Total Skills: 1,397+ | Total Bundles: 37_
@@ -12,7 +12,7 @@ Install the library into Claude Code, then invoke focused skills directly in the
12
12
 
13
13
  ## Why use this repo for Claude Code
14
14
 
15
- - It includes 1,392+ skills instead of a narrow single-domain starter pack.
15
+ - It includes 1,397+ skills instead of a narrow single-domain starter pack.
16
16
  - It supports the standard `.claude/skills/` path and the Claude Code plugin marketplace flow.
17
17
  - It also ships generated bundle plugins so teams can install focused packs like `Essentials` or `Security Developer` from the marketplace metadata.
18
18
  - It includes onboarding docs, bundles, and workflows so new users do not need to guess where to begin.
@@ -12,7 +12,7 @@ Install into the Gemini skills path, then ask Gemini to apply one skill at a tim
12
12
 
13
13
  - It installs directly into the expected Gemini skills path.
14
14
  - It includes both core software engineering skills and deeper agent/LLM-oriented skills.
15
- - It helps new users get started with bundles and workflows rather than forcing a cold start from 1,392+ files.
15
+ - It helps new users get started with bundles and workflows rather than forcing a cold start from 1,397+ files.
16
16
  - It is useful whether you want a broad internal skill library or a single repo to test many workflows quickly.
17
17
 
18
18
  ## Install Gemini CLI Skills
@@ -1,4 +1,4 @@
1
- # Getting Started with Antigravity Awesome Skills (V9.10.0)
1
+ # Getting Started with Antigravity Awesome Skills (V9.11.0)
2
2
 
3
3
  **New here? This guide will help you supercharge your AI Agent in 5 minutes.**
4
4
 
@@ -18,7 +18,7 @@ Kiro is AWS's agentic AI IDE that combines:
18
18
 
19
19
  Kiro's agentic capabilities are enhanced by skills that provide:
20
20
 
21
- - **Domain expertise** across 1,392+ specialized areas
21
+ - **Domain expertise** across 1,397+ specialized areas
22
22
  - **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
23
23
  - **Workflow automation** for common development tasks
24
24
  - **AWS-specific patterns** for serverless, infrastructure, and cloud architecture
@@ -14,7 +14,7 @@ If you came in through a **Claude Code** or **Codex** plugin instead of a full l
14
14
 
15
15
  When you ran `npx antigravity-awesome-skills` or cloned the repository, you:
16
16
 
17
- ✅ **Downloaded 1,392+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
17
+ ✅ **Downloaded 1,397+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
18
18
  ✅ **Made them available** to your AI assistant
19
19
  ❌ **Did NOT enable them all automatically** (they're just sitting there, waiting)
20
20
 
@@ -34,7 +34,7 @@ Bundles are **curated groups** of skills organized by role. They help you decide
34
34
 
35
35
  **Analogy:**
36
36
 
37
- - You installed a toolbox with 1,392+ tools (✅ done)
37
+ - You installed a toolbox with 1,397+ tools (✅ done)
38
38
  - Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools"
39
39
  - You can either **pick skills from the tray** or install that tray as a focused marketplace bundle plugin
40
40
 
@@ -212,7 +212,7 @@ Let's actually use a skill right now. Follow these steps:
212
212
 
213
213
  ## Step 5: Picking Your First Skills (Practical Advice)
214
214
 
215
- Don't try to use all 1,392+ skills at once. Here's a sensible approach:
215
+ Don't try to use all 1,397+ skills at once. Here's a sensible approach:
216
216
 
217
217
  If you want a tool-specific starting point before choosing skills, use:
218
218
 
@@ -343,7 +343,7 @@ Usually no, but if your AI doesn't recognize a skill:
343
343
 
344
344
  ### "Can I load all skills into the model at once?"
345
345
 
346
- No. Even though you have 1,392+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
346
+ No. Even though you have 1,397+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
347
347
 
348
348
  The intended pattern is:
349
349
 
@@ -34,7 +34,7 @@ antigravity-awesome-skills/
34
34
  ├── 📄 CONTRIBUTING.md ← Contributor workflow
35
35
  ├── 📄 CATALOG.md ← Full generated catalog
36
36
 
37
- ├── 📁 skills/ ← 1,392+ skills live here
37
+ ├── 📁 skills/ ← 1,397+ skills live here
38
38
  │ │
39
39
  │ ├── 📁 brainstorming/
40
40
  │ │ └── 📄 SKILL.md ← Skill definition
@@ -47,7 +47,7 @@ antigravity-awesome-skills/
47
47
  │ │ └── 📁 2d-games/
48
48
  │ │ └── 📄 SKILL.md ← Nested skills also supported
49
49
  │ │
50
- │ └── ... (1,392+ total)
50
+ │ └── ... (1,397+ total)
51
51
 
52
52
  ├── 📁 apps/
53
53
  │ └── 📁 web-app/ ← Interactive browser
@@ -100,7 +100,7 @@ antigravity-awesome-skills/
100
100
 
101
101
  ```
102
102
  ┌─────────────────────────┐
103
- │ 1,392+ SKILLS │
103
+ │ 1,397+ SKILLS │
104
104
  └────────────┬────────────┘
105
105
 
106
106
  ┌────────────────────────┼────────────────────────┐
@@ -201,7 +201,7 @@ If you want a workspace-style manual install instead, cloning into `.agent/skill
201
201
  │ ├── 📁 brainstorming/ │
202
202
  │ ├── 📁 stripe-integration/ │
203
203
  │ ├── 📁 react-best-practices/ │
204
- │ └── ... (1,392+ total) │
204
+ │ └── ... (1,397+ total) │
205
205
  └─────────────────────────────────────────┘
206
206
  ```
207
207
 
@@ -0,0 +1,187 @@
1
+ ---
2
+ name: manage-skills
3
+ description: Discover, list, create, edit, toggle, copy, move, and delete AI agent skills across 11 tools (Cursor, Claude, Agents, Windsurf, Copilot, Codex, Cline, Aider, Continue, Roo Code, Augment)
4
+ ---
5
+
6
+ # Manage AI Agent Skills
7
+
8
+ You can manage skills and rules for all major AI coding tools directly from the terminal. This skill teaches you the directory layout, file format, and operations for each tool.
9
+
10
+ ## Supported Tools & Paths
11
+
12
+ ### Directory-based tools (multiple skills)
13
+
14
+ Each skill lives in its own subdirectory with a `SKILL.md` file containing YAML frontmatter.
15
+
16
+ | Tool | Global Path | Project Path |
17
+ |------|------------|--------------|
18
+ | Agents | `~/.agents/skills/<name>/SKILL.md` | `.agents/skills/<name>/SKILL.md` |
19
+ | Cursor | `~/.cursor/skills/<name>/SKILL.md` | `.cursor/skills/<name>/SKILL.md` |
20
+ | Claude | `~/.claude/skills/<name>/SKILL.md` | `.claude/skills/<name>/SKILL.md` |
21
+ | Windsurf | `~/.windsurf/rules/<name>/<name>.md` | `.windsurf/rules/<name>/<name>.md` |
22
+ | Cline | `~/.cline/rules/<name>/<name>.md` | `.cline/rules/<name>/<name>.md` |
23
+ | Continue | `~/.continue/rules/<name>/<name>.md` | `.continue/rules/<name>/<name>.md` |
24
+ | Roo Code | `~/.roo/rules/<name>/<name>.md` | `.roo/rules/<name>/<name>.md` |
25
+
26
+ ### Single-file tools (one config file)
27
+
28
+ | Tool | Global Path | Project Path |
29
+ |------|------------|--------------|
30
+ | Copilot | `~/.github/copilot-instructions.md` | `.github/copilot-instructions.md` |
31
+ | Codex | `~/.codex/AGENTS.md` | `.codex/AGENTS.md` |
32
+ | Aider | `~/.aider.conf.yml` | `.aider.conf.yml` |
33
+ | Augment | `~/augment-guidelines.md` | `augment-guidelines.md` |
34
+
35
+ ### Cursor plugins (read-only)
36
+
37
+ Plugin skills are cached at `~/.cursor/plugins/cache/<org>/<plugin>/<version>/skills/<name>/SKILL.md`. These are managed by Cursor and should not be edited directly.
38
+
39
+ ## Skill File Format
40
+
41
+ For directory-based tools (Agents, Cursor, Claude), skills use YAML frontmatter:
42
+
43
+ ```markdown
44
+ ---
45
+ name: skill-name
46
+ description: Brief description of what this skill does
47
+ ---
48
+
49
+ # Skill Name
50
+
51
+ Skill instructions go here. The AI agent reads this content
52
+ when the skill is activated.
53
+ ```
54
+
55
+ For Windsurf, Cline, Continue, and Roo Code, skills are plain `.md` files (frontmatter optional).
56
+
57
+ ## Operations
58
+
59
+ ### List all skills
60
+
61
+ ```bash
62
+ # List skills for a specific tool
63
+ ls ~/.agents/skills/
64
+ ls ~/.cursor/skills/
65
+ ls ~/.claude/skills/
66
+ ls ~/.windsurf/rules/
67
+ ls ~/.cline/rules/
68
+ ls ~/.continue/rules/
69
+ ls ~/.roo/rules/
70
+
71
+ # Count total skills across all tools
72
+ echo "Agents: $(ls ~/.agents/skills/ 2>/dev/null | wc -l | tr -d ' ')"
73
+ echo "Cursor: $(ls ~/.cursor/skills/ 2>/dev/null | wc -l | tr -d ' ')"
74
+ echo "Claude: $(ls ~/.claude/skills/ 2>/dev/null | wc -l | tr -d ' ')"
75
+ echo "Windsurf: $(ls ~/.windsurf/rules/ 2>/dev/null | wc -l | tr -d ' ')"
76
+ echo "Cline: $(ls ~/.cline/rules/ 2>/dev/null | wc -l | tr -d ' ')"
77
+ echo "Continue: $(ls ~/.continue/rules/ 2>/dev/null | wc -l | tr -d ' ')"
78
+ echo "Roo: $(ls ~/.roo/rules/ 2>/dev/null | wc -l | tr -d ' ')"
79
+
80
+ # Check single-file tools
81
+ test -f ~/.github/copilot-instructions.md && echo "Copilot: exists" || echo "Copilot: not found"
82
+ test -f ~/.codex/AGENTS.md && echo "Codex: exists" || echo "Codex: not found"
83
+ test -f ~/.aider.conf.yml && echo "Aider: exists" || echo "Aider: not found"
84
+ test -f ~/augment-guidelines.md && echo "Augment: exists" || echo "Augment: not found"
85
+ ```
86
+
87
+ ### Read a skill
88
+
89
+ ```bash
90
+ cat ~/.cursor/skills/my-skill/SKILL.md
91
+ ```
92
+
93
+ ### Create a new skill
94
+
95
+ ```bash
96
+ # For Agents/Cursor/Claude (SKILL.md format)
97
+ mkdir -p ~/.agents/skills/my-new-skill
98
+ cat > ~/.agents/skills/my-new-skill/SKILL.md << 'EOF'
99
+ ---
100
+ name: my-new-skill
101
+ description: What this skill does
102
+ ---
103
+
104
+ # My New Skill
105
+
106
+ Instructions for the agent go here.
107
+ EOF
108
+
109
+ # For Windsurf/Cline/Continue/Roo (plain .md format)
110
+ mkdir -p ~/.windsurf/rules/my-new-rule
111
+ cat > ~/.windsurf/rules/my-new-rule/my-new-rule.md << 'EOF'
112
+ # My New Rule
113
+
114
+ Instructions go here.
115
+ EOF
116
+
117
+ # For single-file tools
118
+ cat > .github/copilot-instructions.md << 'EOF'
119
+ Instructions for Copilot go here.
120
+ EOF
121
+ ```
122
+
123
+ ### Enable / Disable a skill
124
+
125
+ Disabling renames the file to `.disabled` so the tool ignores it but the content is preserved:
126
+
127
+ ```bash
128
+ # Disable
129
+ mv ~/.cursor/skills/my-skill/SKILL.md ~/.cursor/skills/my-skill/SKILL.md.disabled
130
+
131
+ # Enable
132
+ mv ~/.cursor/skills/my-skill/SKILL.md.disabled ~/.cursor/skills/my-skill/SKILL.md
133
+ ```
134
+
135
+ ### Copy a skill between tools
136
+
137
+ ```bash
138
+ # Copy from Cursor to Claude
139
+ cp -r ~/.cursor/skills/my-skill ~/.claude/skills/my-skill
140
+
141
+ # Copy from Agents to Windsurf (adapt format)
142
+ mkdir -p ~/.windsurf/rules/my-skill
143
+ cp ~/.agents/skills/my-skill/SKILL.md ~/.windsurf/rules/my-skill/my-skill.md
144
+ ```
145
+
146
+ ### Move a skill
147
+
148
+ ```bash
149
+ mv ~/.cursor/skills/my-skill ~/.agents/skills/my-skill
150
+ ```
151
+
152
+ ### Delete a skill
153
+
154
+ ```bash
155
+ rm -rf ~/.cursor/skills/my-skill
156
+ ```
157
+
158
+ ### Copy a skill from global to project scope
159
+
160
+ ```bash
161
+ cp -r ~/.cursor/skills/my-skill .cursor/skills/my-skill
162
+ ```
163
+
164
+ ### Search across all skills
165
+
166
+ ```bash
167
+ # Search by name
168
+ find ~/.agents/skills ~/.cursor/skills ~/.claude/skills ~/.windsurf/rules ~/.cline/rules ~/.continue/rules ~/.roo/rules -maxdepth 1 -type d 2>/dev/null | sort
169
+
170
+ # Search by content
171
+ grep -rl "search term" ~/.agents/skills/ ~/.cursor/skills/ ~/.claude/skills/ 2>/dev/null
172
+ ```
173
+
174
+ ### Find disabled skills
175
+
176
+ ```bash
177
+ find ~/.agents/skills ~/.cursor/skills ~/.claude/skills -name "*.disabled" 2>/dev/null
178
+ ```
179
+
180
+ ## Guidelines
181
+
182
+ - When the user asks to "manage skills", "list my skills", "create a skill", "copy a skill to X", or similar, use the paths and formats above.
183
+ - Always confirm before deleting skills.
184
+ - When copying between tools with different formats (e.g., Cursor SKILL.md to Windsurf plain .md), adapt the file naming accordingly.
185
+ - Project-scoped skills override global skills of the same name.
186
+ - For single-file tools (Copilot, Codex, Aider, Augment), editing means replacing the entire file content.
187
+ - When creating skills, use kebab-case for directory names (e.g., `my-new-skill`).
@@ -0,0 +1,222 @@
1
+ ---
2
+ name: monte-carlo-monitor-creation
3
+ description: "Guides creation of Monte Carlo monitors via MCP tools, producing monitors-as-code YAML for CI/CD deployment."
4
+ category: data
5
+ risk: safe
6
+ source: community
7
+ source_repo: monte-carlo-data/mc-agent-toolkit
8
+ source_type: community
9
+ date_added: "2026-04-08"
10
+ author: monte-carlo-data
11
+ tags: [data-observability, monitoring, monte-carlo, monitors-as-code]
12
+ tools: [claude, cursor, codex]
13
+ ---
14
+
15
+ # Monte Carlo Monitor Creation Skill
16
+
17
+ This skill teaches you to create Monte Carlo monitors correctly via MCP. Every creation tool runs in **dry-run mode** and returns monitors-as-code (MaC) YAML. No monitors are created directly -- the user applies the YAML via the Monte Carlo CLI or CI/CD.
18
+
19
+ Reference files live next to this skill file. **Use the Read tool** (not MCP resources) to access them:
20
+
21
+ - Metric monitor details: `references/metric-monitor.md` (relative to this file)
22
+ - Validation monitor details: `references/validation-monitor.md` (relative to this file)
23
+ - Custom SQL monitor details: `references/custom-sql-monitor.md` (relative to this file)
24
+ - Comparison monitor details: `references/comparison-monitor.md` (relative to this file)
25
+ - Table monitor details: `references/table-monitor.md` (relative to this file)
26
+
27
+ ## When to activate this skill
28
+
29
+ Activate when the user:
30
+
31
+ - Asks to create, add, or set up a monitor (e.g. "add a monitor for...", "create a freshness check on...", "set up validation for...")
32
+ - Mentions monitoring a specific table, field, or metric
33
+ - Wants to check data quality rules or enforce data contracts
34
+ - Asks about monitoring options for a table or dataset
35
+ - Requests monitors-as-code YAML generation
36
+ - Wants to add monitoring after new transformation logic (when the prevent skill is not active)
37
+
38
+ ## When NOT to activate this skill
39
+
40
+ Do not activate when the user is:
41
+
42
+ - Just querying data or exploring table contents
43
+ - Triaging or responding to active alerts (use the prevent skill's Workflow 3)
44
+ - Running impact assessments before code changes (use the prevent skill's Workflow 4)
45
+ - Asking about existing monitor configuration (use `getMonitors` directly)
46
+ - Editing or deleting existing monitors
47
+
48
+ ---
49
+
50
+ ## Available MCP tools
51
+
52
+ All tools are available via the `monte-carlo` MCP server.
53
+
54
+ | Tool | Purpose |
55
+ | ---------------------------- | ---------------------------------------------------------- |
56
+ | `testConnection` | Verify auth and connectivity before starting |
57
+ | `search` | Find tables/assets by name; use `include_fields` for columns |
58
+ | `getTable` | Schema, stats, metadata, domain membership, capabilities |
59
+ | `getValidationPredicates` | List available validation rule types for a warehouse |
60
+ | `getDomains` | List MC domains (only needed if table has no domain info) |
61
+ | `createMetricMonitorMac` | Generate metric monitor YAML (dry-run) |
62
+ | `createValidationMonitorMac` | Generate validation monitor YAML (dry-run) |
63
+ | `createComparisonMonitorMac` | Generate comparison monitor YAML (dry-run) |
64
+ | `createCustomSqlMonitorMac` | Generate custom SQL monitor YAML (dry-run) |
65
+ | `createTableMonitorMac` | Generate table monitor YAML (dry-run) |
66
+
67
+ ---
68
+
69
+ ## Monitor types
70
+
71
+ | Type | Tool | Use When |
72
+ | -------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
73
+ | **Metric** | `createMetricMonitorMac` | Track statistical metrics on fields (null rates, unique counts, numeric stats) or row count changes over time. Requires a timestamp field for aggregation. |
74
+ | **Validation** | `createValidationMonitorMac` | Row-level data quality checks with conditions (e.g. "field X is never null", "status is in allowed set"). Alerts on INVALID data. |
75
+ | **Custom SQL** | `createCustomSqlMonitorMac` | Run arbitrary SQL returning a single number and alert on thresholds. Most flexible; use when other types don't fit. |
76
+ | **Comparison** | `createComparisonMonitorMac` | Compare metrics between two tables (e.g. dev vs prod, source vs target). |
77
+ | **Table** | `createTableMonitorMac` | Monitor groups of tables for freshness, schema changes, and volume. Uses asset selection at database/schema level. |
78
+
79
+ ---
80
+
81
+ ## Procedure
82
+
83
+ Follow these steps in order. Do NOT skip steps.
84
+
85
+ ### Validation Phase (Steps 1-3) -- MUST complete before any creation tool is called
86
+
87
+ The number one error pattern is agents skipping validation and calling a creation tool with guessed or incomplete parameters. **Every field in the creation call must be grounded in data retrieved during this phase.** Do not proceed to Step 4 until Steps 1-3 are fully satisfied.
88
+
89
+ #### Step 1: Understand the request
90
+
91
+ Ask yourself:
92
+ - What does the user want to monitor? (a specific table, a metric, a data quality rule, cross-table consistency, freshness/volume at schema level)
93
+ - Which monitor type fits? Use the monitor types table above.
94
+ - Does the user have all the details, or do they need guidance?
95
+
96
+ If the user's intent is unclear, ask a focused question before proceeding.
97
+
98
+ #### Step 2: Identify the table(s) and columns
99
+
100
+ If you don't have the table MCON:
101
+ 1. Use `search` with the table name and `include_fields: ["field_names"]` to find the MCON and get column names.
102
+ 2. If the user provided a full table ID like `database:schema.table`, search for it.
103
+ 3. Once you have the MCON, call `getTable` with `include_fields: true` and `include_table_capabilities: true` to verify capabilities and get domain info.
104
+
105
+ If you already have the MCON:
106
+ 1. Call `getTable` with the MCON, `include_fields: true`, and `include_table_capabilities: true`.
107
+
108
+ **CRITICAL: You need the actual column names from `getTable` results. NEVER guess or hallucinate column names.** This is the most common source of monitor creation failures.
109
+
110
+ For monitor types that require a timestamp column (metric monitors), review the column names and identify likely timestamp candidates. Present them to the user if ambiguous.
111
+
112
+ #### Step 3: Handle domain assignment
113
+
114
+ Monitors must be assigned to a domain that contains the table being monitored. The `getTable` response includes a `domains` list with `uuid` and `name`.
115
+
116
+ 1. If `domains` is empty: skip domain assignment.
117
+ 2. If `domains` has exactly one entry: default `domain_id` to that domain's UUID.
118
+ 3. If `domains` has multiple entries: present only those domains and ask the user to pick.
119
+
120
+ Do NOT present all account domains as options -- only domains that contain the table are valid.
121
+
122
+ **ALWAYS check the table's `domains` BEFORE calling any creation tool.**
123
+
124
+ ---
125
+
126
+ ### Creation Phase (Steps 4-8)
127
+
128
+ Only enter this phase after the validation phase is complete with real data from MCP tools.
129
+
130
+ #### Step 4: Load the sub-skill reference
131
+
132
+ Based on the monitor type, read the detailed reference for parameter guidance:
133
+
134
+ - **Metric** -- Read the detailed reference: `references/metric-monitor.md` (relative to this file)
135
+ - **Validation** -- Read the detailed reference: `references/validation-monitor.md` (relative to this file)
136
+ - **Custom SQL** -- Read the detailed reference: `references/custom-sql-monitor.md` (relative to this file)
137
+ - **Comparison** -- Read the detailed reference: `references/comparison-monitor.md` (relative to this file)
138
+ - **Table** -- Read the detailed reference: `references/table-monitor.md` (relative to this file)
139
+
140
+ #### Step 5: Ask about scheduling
141
+
142
+ **Skip this step for table monitors.** Table monitors do not support the `schedule` field in MaC YAML — adding it will cause a validation error on `montecarlo monitors apply`. Table monitor scheduling is managed automatically by Monte Carlo.
143
+
144
+ For all other monitor types, the creation tools default to a fixed schedule running every 60 minutes. Present these options:
145
+
146
+ 1. **Fixed interval** -- any integer for `interval_minutes` (30, 60, 90, 120, 360, 720, 1440, etc.)
147
+ 2. **Dynamic** -- MC auto-determines when to run based on table update patterns.
148
+ 3. **Loose** -- runs once per day.
149
+
150
+ Schedule format in MaC YAML:
151
+ - Fixed: `schedule: { type: fixed, interval_minutes: <N> }`
152
+ - Dynamic: `schedule: { type: dynamic }`
153
+ - Loose: `schedule: { type: loose, start_time: "00:00" }`
154
+
155
+ #### Step 6: Confirm with the user
156
+
157
+ Before calling the creation tool, present the monitor configuration in plain language:
158
+ - Monitor type
159
+ - Target table (and columns if applicable)
160
+ - What it checks / what triggers an alert
161
+ - Domain assignment
162
+ - Schedule
163
+
164
+ Ask: "Does this look correct? I'll generate the monitor configuration."
165
+
166
+ **NEVER call the creation tool without user confirmation.**
167
+
168
+ #### Step 7: Create the monitor
169
+
170
+ Call the appropriate creation tool with the parameters built in previous steps. Always pass an MCON when possible. If only table name is available, also pass warehouse.
171
+
172
+ #### Step 8: Present results
173
+
174
+ **CRITICAL: Always include the YAML in your response.** The user needs copy-pasteable YAML.
175
+
176
+ 1. If a non-default schedule was chosen, modify the schedule section in the YAML before presenting.
177
+ 2. Wrap the YAML in the full MaC structure (see "MaC YAML format" section below).
178
+ 3. ALWAYS present the full YAML in a ```yaml code block.
179
+ 4. Explain where to put it and how to apply it (see below).
180
+ 5. ALWAYS use ISO 8601 format for datetime values.
181
+ 6. NEVER reformat YAML values returned by creation tools.
182
+
183
+ ---
184
+
185
+ ## MaC YAML format
186
+
187
+ The YAML returned by creation tools is the monitor definition. It must be wrapped in the standard MaC structure to be applied:
188
+
189
+ ```yaml
190
+ montecarlo:
191
+ <monitor_type>:
192
+ - <returned yaml>
193
+ ```
194
+
195
+ For example, a metric monitor would look like:
196
+
197
+ ```yaml
198
+ montecarlo:
199
+ metric:
200
+ - <yaml returned by createMetricMonitorMac>
201
+ ```
202
+
203
+ **Important:** `montecarlo.yml` (without a directory path) is a separate Monte Carlo project configuration file -- it is NOT the same as a monitor definition file. Monitor definitions go in their own `.yml` files, typically in a `monitors/` directory or alongside dbt model schema files.
204
+
205
+ Tell the user:
206
+ - Save the YAML to a `.yml` file (e.g. `monitors/<table_name>.yml` or in their dbt schema)
207
+ - Apply via the Monte Carlo CLI: `montecarlo monitors apply --namespace <namespace>`
208
+ - Or integrate into CI/CD for automatic deployment on merge
209
+
210
+ ---
211
+
212
+ ## Common mistakes to avoid
213
+
214
+ - **NEVER guess column names.** Always get them from `getTable`.
215
+ - **NEVER skip the confirmation step** (Step 6).
216
+ - For metric monitors, `aggregate_time_field` MUST be a real timestamp column from the table.
217
+ - For validation monitors, conditions match INVALID data, not valid data.
218
+ - Always pass an MCON when possible. If only table name is available, also pass warehouse.
219
+ - **ALWAYS check table's `domains` BEFORE calling any creation tool.**
220
+ - ALWAYS use ISO 8601 format for datetime values.
221
+ - NEVER reformat YAML values returned by creation tools.
222
+ - Do not call creation tools before the validation phase is complete.