Home / coupler-io / skills · capability/refine-prompt/SKILL.md · GitHub

refine-prompt skillA

refine-prompt is agent-read markdown (skill) from coupler-io/skills: Use this skill when the user's request is vague, incomplete, or poorly structured and needs to be sharpened into a detailed, actionable analytics prompt before analysis. Triggers include underspecified asks like 'how's my marketing doing', 'show me sales data', 'what campaigns performed best' — requests missing a time period, explicit metrics, data sources, comparison criteria, or output format..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Refine Prompt

You are a specialized prompt refinement agent for Coupler.io's multi-agent AI system.
Your sole purpose is to transform vague, incomplete, or poorly structured user requests into detailed, actionable prompts that generate high-quality data analysis.

## TASK

Take the user's original prompt and enhance it by adding missing critical details while preserving their core intent.

## GOOD PROMPT INCLUDES THE FOLLOWING

1. **Time period**: Specific date ranges or relative periods (last 30 days, Q4 2024, year-over-year).
2. **Metrics**: Explicit KPIs to analyze (CTR, conversion rate, revenue, ROI, engagement rate, etc).
3. **Data sources**: Which platforms/data flows to examine.
4. **Comparison criteria**: What to compare against (previous period, benchmarks, goals, channels).
5. **Output format**: How results should be presented (summary, detailed breakdown, tables, recommendations).
6. **Business context**: Why this analysis matters or what decision it informs.

## PROMPTS THAT NEED NO REFINEMENT

Do NOT refine prompts that already contain:
- **Specific time periods** and date ranges.
- **Clear metrics** or KPIs to analyze.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add coupler-io/skills/refine-prompt@git:20260826.260c8c0
Exact content
mdr add coupler-io/skills/refine-prompt@sha256:69822375c985ebdd

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jgz5scgzijye3rnq.svg)](https://markdownregistry.com/a/art_jgz5scgzijye3rnq)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260826.260c8c0 latest2026-08-26 260c8c0 4,251 BA view · diff
git:20260723.58d81012026-07-23 58d8101 4,204 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4251 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

coupler-io/skills · 34 stars · license none · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jgz5scgzijye3rnq
GET https://markdownregistry.com/api/v1/resolve?ref=coupler-io/skills/refine-prompt
GET https://markdownregistry.com/api/v1/blob/69822375c985ebdd7bf9a5d16cc9f2e122f869009a526804a257a60c16ddb409

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from coupler-io/skills

create-dataflow skill
coupler-io/skills · capability/create-dataflow/SKILL.md · Use this skill when the user wants to create a new dataflow, set up a new data import, connect a new data source to a…
git:20260826.260c8c0 · audit A · 34 stars
generate-data-set-context skill
coupler-io/skills · capability/generate-data-set-context/SKILL.md · Use this skill when the user wants to explore a dataset's context, or write or update documentation for the data it…
git:20260826.260c8c0 · audit A · 34 stars
get-started skill
coupler-io/skills · capability/get-started/SKILL.md · Use this skill when the user's Coupler.io workspace is NEW or EMPTY — no datasets, no credentials — and they want their…
v0.1.0 · audit A · 34 stars
google-ads-custom-gaql skill
coupler-io/skills · capability/google-ads-custom-gaql/SKILL.md · Use this skill when the user needs Google Ads data that no packaged report type carries, or asks for a Custom GAQL…
git:20260905.0af2a91 · audit A · 34 stars
report-generation skill
coupler-io/skills · capability/report-generation/SKILL.md · Use this skill to produce a structured business report from analysis output and validate it before delivery — turning…
git:20260826.260c8c0 · audit A · 34 stars
ecom-analytics skill
coupler-io/skills · ecommerce/ecom-analytics/SKILL.md · Use this skill when the user wants to analyze e-commerce performance, review funnel conversion, investigate AOV or…
git:20260827.ea5b9df · audit A · 34 stars
shopify-inventory-and-stockout-risk skill
coupler-io/skills · ecommerce/shopify/shopify-inventory-and-stockout-risk/SKILL.md · Use for "what's about to run out", "what should I reorder", "when do I need to place the order", "how much stock do I…
v1.0.0 · audit B · 34 stars
shopify-product-and-variant-sales skill
coupler-io/skills · ecommerce/shopify/shopify-product-and-variant-sales/SKILL.md · Use for "which products are selling", "what are my best sellers", "which variants should I drop", "what's my margin by…
v1.0.0 · audit B · 34 stars
shopify-repeat-purchase-and-retention skill
coupler-io/skills · ecommerce/shopify/shopify-repeat-purchase-and-retention/SKILL.md · Use for "what's our repeat rate", "do customers come back", "which campaign brings customers who buy again", "what's…
v1.0.0 · audit B · 34 stars
shopify-store-performance skill
coupler-io/skills · ecommerce/shopify/shopify-store-performance/SKILL.md · Use for Shopify store questions like "how did the store do last month", "why did our store revenue drop", "what's our…
v1.1.0 · audit B · 34 stars
finance-analytics skill
coupler-io/skills · finance/finance-analytics/SKILL.md · Use this skill when the user wants to analyze financial performance, review P&L health, monitor MRR/ARR, investigate…
git:20260827.ea5b9df · audit A · 34 stars
facebook-ads-audience-analysis skill
coupler-io/skills · marketing-and-ads/facebook-ads/facebook-ads-audience-analysis/SKILL.md · Use for "which audiences are working on Meta", "is my lookalike better than broad", "is retargeting worth it", "who is…
v1.0.0 · audit A · 34 stars

Every file in coupler-io/skills

Other files named refine-prompt

refine-prompt skill
iliaal/ai-skills · skills/refine-prompt/SKILL.md · Transforms vague prompts into precise, structured AI instructions. Use when asked to refine, improve, or sharpen a…
git:20260908.6c9fed1 · audit A · 42 stars
refine-prompt skill
iliaal/whetstone · distillery/generated-skills/refine-prompt/SKILL.md · Transforms vague or rough prompts into precise, structured AI instructions. Use when asked to "refine prompt", "improve…
git:20260227.215f429 · audit A · 34 stars

Browse by kind, by grade A, or by owner.