ctr-json-normalizer
Normalize the final JSON output of a single-session CTR product-card click diagnosis. Use after the diagnosis draft is complete and before replying, whenever the report must contain exactly the agreed query, clicked item, unclicked items, five fixed dimensions, structured suggestions, and limitations. Skill: ctr-json-normalizer Owner: rawven Summary: Normalize the final JSON output of a single-session CTR product-card click diagnosis. Use after the diagnosis draft is complete and before replying, whenever the report must contain exactly the agreed query, clicked item, unclicked items, five fixed dimensions, structured suggestions, and limitations. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-15T08:09:13.22
Rank
62
Safety
84
Downloads
1.6k
Updated
Oct 10, 2026
Version
0.1.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.6K downloadsadoption · observed Oct 10, 2026
- Latest release
- 0.1.0release · observed Aug 15, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s178t2fxzjz0v8yxcg3emqtq498cgd4w:ctr-json-normalizer- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-rawven-ctr-json-normalizer/snapshot"
Documentation
CLAWHUB
5,163 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: ctr-json-normalizer
description: Normalize the final JSON output of a single-session CTR product-card click diagnosis. Use after the diagnosis draft is complete and before replying, whenever the report must contain exactly the agreed query, clicked item, unclicked items, five fixed dimensions, structured suggestions, and limitations.
---
# CTR JSON Normalizer
Run this Skill once as the final step of every CTR diagnosis. It formats and validates a completed diagnosis; it does not fetch images, compare products, infer causes, or write new business suggestions.
## Input
Pass one JSON object through stdin:
```json
{
"session": { "query": "", "clicked_item_id": "", "items": [] },
"report": { }
}
```
`report` may be a JSON object or a JSON string. `session.items` must be the original card list, with `item_id`, `position`, and `clicked` where available.
## Run
```bash
python3 scripts/normalize_ctr_report.py <<'JSON'
{ "session": { "query": "...", "clicked_item_id": "...", "items": [] }, "report": {} }
JSON
```
## Required Workflow
1. Finish all comparison and image-fact collection first.
2. Build the diagnosis draft as JSON, using evidence already collected.
3. Run `scripts/normalize_ctr_report.py` with the original session and the draft.
4. If it returns `error`, fix the draft JSON and run it again.
5. Return the script stdout verbatim. Do not wrap it in Markdown or append explanatory text.
The script fixes only the report envelope: root fields, candidate item coverage, dimension order, allowed status values, suggestion field shape, and limitations. A missing dimension becomes `unknown` with no suggestion; no factual claim is invented.README.md
# ctr-json-normalizer Normalize structured JSON reports for single-session CTR product-card click diagnoses.
_meta.json
{
"ownerId": "kn70wykycqrsb3zaj7361cbbw18cg811",
"slug": "ctr-json-normalizer",
"version": "0.1.0",
"publishedAt": 1786781353227
}skill-card.md
## Description: Normalize the final JSON output of a single-session CTR product-card click diagnosis. This skill is ready for commercial/non-commercial use. ## Publisher: [rawven](https://clawhub.ai/user/rawven) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agents use this skill as the final step in a CTR product-card click diagnosis to normalize a completed draft into the required JSON report contract before responding. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Malformed or incomplete diagnosis drafts can produce an error response or unknown fields in the normalized JSON. Mitigation: Review the report data supplied to the script, fix invalid drafts, and rerun the normalizer until the output satisfies the required JSON contract. Risk: The skill normalizes existing CTR diagnosis data but does not verify factual claims, fetch images, compare products, or generate new business suggestions. Mitigation: Complete evidence collection and diagnosis drafting before running the normalizer, then review the normalized output before using it in downstream decisions. ## Reference(s): - [Source repository](https://github.com/Rawven/ctr-json-normalizer) - [ClawHub skill page](https://clawhub.ai/rawven/skills/ctr-json-normalizer) ## Skill Output: **Output Type(s):** [JSON, Shell commands, Guidance] **Output Format:** [Minified JSON emitted to stdout, with shell command usage instructions in the skill workflow] **Output Parameters:** [1D] **Other Properties Related to Output:** [Returns an error JSON object when the supplied draft cannot be parsed or normalized.] ## Skill Version(s): 0.1.0 (source: server release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/rawven/skills/ctr-json-normalizer",
"sourceUrl": "https://clawhub.ai/rawven/skills/ctr-json-normalizer",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T07:50:44.533Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-rawven-ctr-json-normalizer/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-rawven-ctr-json-normalizer/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T07:50:44.533Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.6K downloads",
"href": "https://clawhub.ai/rawven/ctr-json-normalizer",
"sourceUrl": "https://clawhub.ai/rawven/ctr-json-normalizer",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T07:50:44.533Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.0",
"href": "https://clawhub.ai/rawven/ctr-json-normalizer",
"sourceUrl": "https://clawhub.ai/rawven/ctr-json-normalizer",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-15T08:09:13.227Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-rawven-ctr-json-normalizer/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-rawven-ctr-json-normalizer/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.0",
"description": "Initial release of ctr-json-normalizer Skill. - Normalizes and validates JSON output for CTR product-card click diagnosis. - Ensures the report contains exactly the required fields: query, clicked item, unclicked items, five fixed dimensions, structured suggestions, and limitations. - Designed as the final step after diagnosis drafting, before responding. - Automatic error handling: script returns \"error\" if the output does not meet requirements. - Does not fetch images, infer causes, or generate new business suggestions.",
"href": "https://clawhub.ai/rawven/ctr-json-normalizer",
"sourceUrl": "https://clawhub.ai/rawven/ctr-json-normalizer",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-15T08:09:13.227Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
