text

name	text
description	Use this skill when the user wants to create, generate, save, export, download, convert, format, clean, or localize plain text, TXT, Markdown/MD, or HTML file deliverables. This skill produces text-family artifacts such as .txt, .text, .md, .markdown, or .html files and exposes the final file for download.
license	MIT-0
source	https://clawhub.ai/ivangdavila/text
artifact_types	["text","txt","md","markdown","html"]
triggers	["create text","create text file","create txt","create txt file","create markdown","create markdown file","create md","create md file","create html","create html file","generate text","generate text file","generate txt","generate txt file","generate markdown","generate markdown file","generate md","generate md file","generate html","generate html file","save as text","save as txt","save as markdown","save as md","save as html","export text","export text file","export markdown","export markdown file","export html","export html file","download text","download markdown","download html","创建文本","创建文本文件","创建 txt","创建 txt 文件","创建 markdown","创建 markdown 文件","创建 md","创建 md 文件","创建 html","创建 html 文件","生成文本","生成文本文件","生成 txt","生成 txt 文件","生成 markdown","生成 markdown 文件","生成 md","生成 md 文件","生成 html","生成 html 文件","保存为 txt","保存成 txt","保存为 md","保存成 md","保存为 markdown","保存成 markdown","保存为 html","保存成 html","导出文本","导出文本文件","导出 txt","导出 txt 文件","导出 markdown","导出 markdown 文件","导出 md","导出 md 文件","导出 html","导出 html 文件","下载文本","下载文本文件","下载 txt","下载 txt 文件","下载 markdown","下载 markdown 文件","下载 md","下载 md 文件","下载 html","下载 html 文件"]
use_when	["User wants a text-family file deliverable in TXT, plain text, Markdown/MD, or HTML format.","User asks to create, generate, save, export, or download text-based content as a file.","User wants current context, generated content, notes, provided text, or transformed text saved as TXT, Markdown, or HTML.","User asks to clean, normalize, format, localize, or transform text-based content intended for TXT, Markdown, or HTML output.","User asks to convert simple text or Markdown content to HTML, or HTML/plain text content to Markdown/text when no dedicated document skill is required."]
avoid_when	["User wants a PDF file; use the PDF skill.","User wants a DOCX/Word document; use the DOCX or word-docx skill.","User wants a PPT/PPTX slide deck; use the PPTX skill.","User wants an XLS/XLSX/CSV/TSV spreadsheet deliverable; use the XLSX skill.","User wants provider-specific workflows, tickets, approvals, or resource operations rather than a text file."]

AtlasClaw Workspace Output

When producing a user-facing .txt, .md, .markdown, or .html file:

1. Write only the final content under the current work_dir, preferably exports/<descriptive-name>.<ext> unless the user requested a safe relative filename.
2. Use UTF-8 text. For HTML, produce a complete standalone document when the user asks for an HTML file.
3. Expose the final file through the existing workspace download flow by passing its work_dir-relative path as download_paths.
4. Prefer writing a new output file instead of editing source files in place unless the user explicitly asks for an in-place edit.
5. Do not expose scripts, logs, caches, hidden files, intermediate files, or source documents as downloads.

AtlasClaw Runtime Commands

Prefer skill_read, skill_write, and skill_edit for simple file operations. If a transformation needs shell features such as pipes, redirects, globs, or compound commands, run it through bash -lc '<command>' with explicitly named work_dir-relative files, or use a python3 -c command that reads and writes explicit paths. Do not read or print .env, key, token, cookie, or password files unless the user explicitly requests it and the output is redacted.

Quick Reference

Task	Load
Text cleanup, extraction, Markdown, or HTML shaping	data.md
Translation/localization for text output	localization.md

---

Universal Text Rules

Encoding

• Always verify encoding first: file -bi document.txt
• Normalize line endings: tr -d '\r'
• Remove BOM if present: write a normalized copy instead of editing the source in place.

Whitespace

• Collapse multiple spaces: sed 's/[[:space:]]\+/ /g'
• Trim leading/trailing: sed 's/^[[:space:]]*//;s/[[:space:]]*$//'

Common Traps

• Smart quotes (\u201c, \u201d, \u2018, \u2019) break parsers -> normalize to ASCII quotes.
• Em/en dashes (\u2013, \u2014) break ASCII-only output -> normalize to -.
• Zero-width chars invisible but break comparisons → strip them
• String length ≠ byte length in UTF-8 ("café" = 4 chars, 5 bytes)

---

Format Detection

# Detect encoding
file -I document.txt

# Detect line endings
cat -A document.txt | head -1
# ^M at end = Windows (CRLF)
# No ^M = Unix (LF)

# Detect likely HTML
grep -qiE '<html|<!doctype html' document.html

---

Quick Transformations

Task	Command
Lowercase	tr '[:upper:]' '[:lower:]'
Remove punctuation	tr -d '[:punct:]'
Count words	wc -w
Count unique lines	sort -u | wc -l
Find duplicates	sort | uniq -d
Extract emails	grep -oE '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}'
Extract URLs	`grep -oE 'https?://[^[:space:]<>"{}

---

Before Processing Checklist

• Encoding verified (UTF-8?)
• Line endings normalized
• Target format/style defined (TXT, Markdown, or HTML)
• Edge cases considered (empty, Unicode, special chars)