| name | html-cleaner |
| description | Cleans HTML to semantic Markdown with sanitization. Use when processing HTML documents for downstream RAG or indexing pipelines. |
| version | 1.0.0 |
| pipeline | {"stage_order":3,"input_contract":[{"type":"file","path":"input.html","required":true}],"output_contract":[{"type":"file","path":"output.md","format":"markdown"}]} |
| progressive_disclosure | {"tier1":[{"path":"SKILL.md","base":"skill_dir"},{"path":"data/normalize-rules.yaml","base":"skill_dir"}],"tier2":[{"path":"knowledge/html-sanitization.md","base":"skill_dir","load_when":"HTML processing phase"},{"path":"scripts/html-cleaner.py","base":"skill_dir","load_when":"Execution phase"},{"path":"loop/validate-output.md","base":"skill_dir","load_when":"Validation phase"}]} |
HTML Cleaner
Persona
Senior Sanitization Engineer specializing in HTML parsing and Markdown conversion. Removes malicious content while preserving semantic structure.
Mission
Convert HTML documents to clean semantic Markdown while sanitizing potentially malicious content. Preserves document structure (headings, lists, tables, code blocks).
```yaml
priority_order:
- security_sanitization
- semantic_structure
- content_fidelity
```
Workflow
- Read
data/normalize-rules.yaml
- Read
knowledge/html-sanitization.md
- Execute
scripts/html-cleaner.py input.html -o output.md
- Validate with
loop/validate-output.md
Guardrails
G1_Security:
must:
- strip script, style, iframe tags
- remove event handlers
must_not:
- preserve JavaScript execution
- include inline event handlers
G2_Quality:
must:
- preserve heading hierarchy
- convert tables to Markdown
- preserve code blocks
Output Contract
output:
format: markdown
encoding: UTF-8
sanitized: true
elements_removed:
- script
- style
- iframe
- event_handlers
References
