Obsidian Clipper Template Creator

1---
2name: obsidian-clipper-template-creator
3description: Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
4---
5 
6# Obsidian Web Clipper Template Creator
7 
8This skill helps you create importable JSON templates for the Obsidian Web Clipper.
9 
10## Workflow
11 
121. **Identify User Intent:** specific site (YouTube), specific type (Recipe), or general clipping?
132. **Check Existing Bases:** The user likely has a "Base" schema defined in `Templates/Bases/`.
14    - **Action:** Read `Templates/Bases/*.base` to find a matching category (e.g., `Recipes.base`).
15    - **Action:** Use the properties defined in the Base to structure the Clipper template properties.
16    - See [references/bases-workflow.md](references/bases-workflow.md) for details.
173. **Fetch & Analyze Reference URL:** Validate variables against a real page.
18    - **Action:** Ask the user for a sample URL of the content they want to clip (if not provided).
19    - **Action (REQUIRED):** Use `WebFetch` or a browser DOM snapshot to retrieve page content before choosing any selector.
20    - **Action:** Analyze the HTML for Schema.org JSON, Meta tags, and CSS selectors.
21    - **Action (REQUIRED):** Verify each selector against the fetched content. Do not guess selectors.
22    - See [references/analysis-workflow.md](references/analysis-workflow.md) for analysis techniques.
234. **Draft the JSON:** Create a valid JSON object following the schema.
24    - See [references/json-schema.md](references/json-schema.md).
255. **Verify Variables:** Ensure the chosen variables (Preset, Schema, Selector) exist in your analysis.
26    - **Action (REQUIRED):** If a selector cannot be verified from the fetched content, state that explicitly and ask for another URL.
27    - See [references/variables.md](references/variables.md).
28 
29## Selector Verification Rules
30 
31- **Always verify selectors** against live page content before responding.
32- **Never guess selectors.** If the DOM cannot be accessed or the element is missing, ask for another URL or a screenshot.
33- **Prefer stable selectors** (data attributes, semantic roles, unique IDs) over fragile class chains.
34- **Document the target element** in your reasoning (e.g., "About sidebar paragraph") to reduce mismatch.
35 
36## Output Format
37 
38**ALWAYS** output the final result as a JSON code block that the user can copy and import.
39 
40```json
41{
42  "schemaVersion": "0.1.0",
43  "name": "My Template",
44  ...
45}
46```
47 
48## Resources
49 
50- [references/variables.md](references/variables.md) - Available data variables.
51- [references/filters.md](references/filters.md) - Formatting filters.
52- [references/json-schema.md](references/json-schema.md) - JSON structure documentation.
53- [references/bases-workflow.md](references/bases-workflow.md) - How to map Bases to Templates.
54- [references/analysis-workflow.md](references/analysis-workflow.md) - How to validate page data.
55 
56### Official Documentation
57 
58- [Variables](https://help.obsidian.md/web-clipper/variables)
59- [Filters](https://help.obsidian.md/web-clipper/filters)
60- [Templates](https://help.obsidian.md/web-clipper/templates)
61 
62## Examples
63 
64See [assets/](assets/) for JSON examples.
65