name: your-skill-name description: >- Brief description of what this skill does and what tools/integrations it uses. Use when: (1) first trigger scenario, (2) second trigger scenario, (3) third trigger scenario.
Your Skill Name
One-line summary of the skill's purpose and outcome.
Success target: [Measurable success criteria — e.g., "90%+ of X produce correct Y."]
Task
[High-level pipeline in one line: Step A → Step B → Step C → Return result.]
1. Accept Input
Input Formats
Format A (primary):
field_1: Descriptionfield_2: Descriptionfield_3: Description (optional)
Format B (fallback): Any raw text block to analyze.
If only raw text is provided, treat it as the full content to analyze.
2. Classify / Analyze
Categories
| Category | Description | Example Indicators |
|---|---|---|
category_a |
What it means | "keyword_1", "keyword_2" |
category_b |
What it means | "keyword_3", "keyword_4" |
category_c |
What it means | "keyword_5", "keyword_6" |
Classification Process
Step 1: Scan for indicators
Read the input and identify:
- [Signal type 1]
- [Signal type 2]
- [Signal type 3]
Step 2: Match categories
Compare indicators against the categories above. A single input may match multiple categories.
Step 3: Extract structured data per match
For each match, extract:
category: The matched categorykey_field_1: Extracted valuekey_field_2: Extracted valuedeadline: Date if found (YYYY-MM-DD)
Step 4: Calculate confidence score
Each match gets an independent score. Use the point-based system below.
Confidence Scoring System
Start with confidence = 0.0 and add points:
| Signal | Points | Examples |
|---|---|---|
| [Signal A] | +0.30 | "example_1", "example_2" |
| [Signal B] | +0.25 | "example_3", "example_4" |
| [Signal C] | +0.20 | "example_5", "example_6" |
| [Signal D] | +0.15 | "example_7", "example_8" |
| [Signal E] | +0.10 | "example_9", "example_10" |
Maximum possible: 1.0
Important: All example breakdowns in this skill must sum correctly. Verify: 0.30 + 0.25 + 0.20 + 0.15 + 0.10 = 1.0 ✓
Examples:
- "[Full match example]" → 0.30 + 0.25 + 0.20 + 0.15 + 0.10 = 1.0
- "[Partial match example]" → 0.20 = 0.20 (below threshold)
What to Ask If Missing
| Missing Signal | Question to Ask |
|---|---|
| [Signal A] | "Question to clarify?" |
| [Signal B] | "Question to clarify?" |
| [Signal D] | "Question to clarify?" |
Classification Output
{
"matches": [
{
"category": "category_a",
"confidence": 1.0,
"confidence_breakdown": {
"signal_a": 0.30,
"signal_b": 0.25,
"signal_c": 0.20,
"signal_d": 0.15,
"signal_e": 0.10
},
"key_field_1": "extracted_value",
"key_field_2": "extracted_value",
"priority": "Medium",
"suggested_title": "Action: Category — Context — Entity",
"notes": "Brief description.",
"missing_signals": []
}
]
}
Confidence Thresholds
| Confidence | Decision | Action |
|---|---|---|
>= 0.85 |
High confidence | Proceed automatically |
0.45 - 0.84 |
Needs review | Proceed with review flag |
< 0.45 |
Ignore | No action taken |
3. Decision Logic
1. Classify input → get matches[]
2. If matches[] is empty → inform user, done
3. For each match in matches[]:
a. confidence >= 0.85 → Execute action (auto)
b. confidence >= 0.45 and < 0.85 → Execute action with review flag
c. confidence < 0.45 → Skip, note below threshold
4. On failure for one match → Log error, continue with remaining
5. After all processed → Return aggregated response (see Section 5)
Each match is independent. A failure on one does not block the others.
4. Execute Action
[Describe the action — e.g., create a record, call an API, generate output.]
Required Tools / Integrations
For tool schemas, field definitions, and detailed reference material, read REFERENCE.md.
5. Response to User
Success (one or more actions taken)
[N] action(s) completed from this input.
For each high-confidence action:
[n]. Title: [title]
Status: [status]
Priority: [priority]
Record: [id]
For each mid-confidence action:
[n]. Title: [title]
Status: Pending Review
Priority: [priority]
Record: [id]
Flagged for review — confidence was [X]%.
If any matches were skipped, append:
Skipped: [category] — confidence [X]% below 45% threshold.
If any actions failed, append:
Failed: [category] — [error message]. Please handle manually.
No Matches Found
Analyzed input — no [domain] action detected.
No actions were taken. [Brief explanation.]
All Below Threshold
Possible [domain] matches detected, but confidence too low.
[category]: [X]% (below 45% threshold)
No actions taken. Provide more context if action is needed.
6. Mapping Tables
Tag / Category Mapping
| Category | Recommended Tags |
|---|---|
category_a |
Tag1, Tag2 |
category_b |
Tag1, Tag3 |
category_c |
Tag2, Tag3 |
Priority Mapping
| Condition | Priority | Reasoning |
|---|---|---|
| Urgent indicators, deadline < 7 days | Urgent | Immediate action required |
| Important indicators, deadline 7-14 days | High | Near-term attention needed |
| Explicit deadline 14-30 days | Medium | Standard timeline |
| Explicit deadline 30-60 days | Low | Enough lead time |
| No urgency cues, deadline > 60 days | Low | Can be scheduled later |
| No cues found | Medium | Default to moderately important |
Handling Errors
| Error | Action |
|---|---|
| Cannot parse input | Ask user for clearer text |
| Classification returned invalid output | Retry once, then create review-flagged action |
| Action failed for one match | Log error, continue remaining |
| Action failed for all matches | Report all failures, ask user how to proceed |
| All matches below threshold | Report with confidence scores, no action taken |
Example
For a complete worked example with input, classification, and output, read EXAMPLE.md.