Core Position
This skill solves the specific engineering problem described in the trigger conditions. It focuses on reliable, auditable execution with clear error reporting.
Modes
/analyze-json-data
Default mode. Performs the core task with standard configuration.
/analyze-json-data --verbose
Verbose mode. Includes detailed logging and intermediate results.
Execution Steps
- Parse input — Validate and parse the input data; report any structural issues
- Validate — Confirm all required fields/parameters are present and well-formed
- Execute — Perform the transformation/action with validated input
- Verify — Check the output is well-formed and complete
- Report — Return structured output with a brief summary of what was done
Mandatory Rules
Do not
- Do not make up facts or claim actions were taken that were not
- Do not hardcode API keys — use
os.getenv("API_KEY")instead - Do not store sensitive user data beyond the current session
- Do not exceed token budget without warning the user first
- Do not activate for off-topic requests — return a brief decline message
Do
- Validate all inputs before acting
- Handle errors gracefully with actionable error messages
- Log actions taken for auditability
- State explicitly when you are uncertain or data is insufficient
Quality Bar
| Criterion | Minimum | Ideal |
|---|---|---|
| Task completion | Core task completes without error | Full task with all edge cases handled |
| Error reporting | Clear error message on failure | Actionable error with suggested fix |
| User communication | Brief summary of what was done | Detailed log with reasoning for decisions |
| Input validation | Rejects malformed input | Accepts valid input, explains rejection for invalid |
A good output is one where all edge cases are handled gracefully with clear user communication.
Good vs. Bad Examples
| Scenario | Bad | Good |
|---|---|---|
| Task unclear | Attempts anyway, may be wrong | Asks for clarification before proceeding |
| Error | Technical error message | "Cannot [action]: [reason] — suggest [alternative]" |
| Partial success | Reports "Done" | Reports "Done, but [partial] not completed — see details" |
| Edge case | Silently skips or crashes | Documents edge case and handles gracefully |