text-formatter

@catlog22/text-formatter

catlog22

1,008

86 forks

Updated 1/18/2026

View on GitHub

Transform and optimize text content with intelligent formatting. Output BBCode + Markdown hybrid format optimized for forums. Triggers on "format text", "text formatter", "排版", "格式化文本", "BBCode".

Installation

$skills install @catlog22/text-formatter

Claude Code

Cursor

Copilot

Codex

Antigravity

Details

Repositorycatlog22/Claude-Code-Workflow

Path.claude/skills/text-formatter/SKILL.md

Branchmain

Scoped Name@catlog22/text-formatter

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions

name: text-formatter description: Transform and optimize text content with intelligent formatting. Output BBCode + Markdown hybrid format optimized for forums. Triggers on "format text", "text formatter", "排版", "格式化文本", "BBCode". allowed-tools: Task, AskUserQuestion, Read, Write, Bash, Glob

Text Formatter

Transform and optimize text content with intelligent structure analysis. Output format: BBCode + Markdown hybrid optimized for forum publishing.

Architecture Overview

┌─────────────────────────────────────────────────────────────────┐
│  Text Formatter Architecture (BBCode + MD Mode)                  │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  Phase 1: Input Collection  → 接收文本/文件                       │
│           ↓                                                      │
│  Phase 2: Content Analysis  → 分析结构、识别 Callout/Admonition  │
│           ↓                                                      │
│  Phase 3: Format Transform  → 转换为 BBCode+MD 格式              │
│           ↓                                                      │
│  Phase 4: Output & Preview  → 保存文件 + 预览                    │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Key Design Principles

Single Format Output: BBCode + Markdown hybrid (forum optimized)
Pixel-Based Sizing: size=150/120/100/80 (not 1-7 levels)
Forum Compatibility: Only use widely-supported BBCode tags
Markdown Separators: Use --- for horizontal rules (not [hr])
No Alignment Tags: [align] not supported, avoid usage

Format Specification

Supported BBCode Tags

Tag	Usage	Example
`[size=N]`	Font size (pixels)	`[size=120]Title[/size]`
`[color=X]`	Text color (hex/name)	`[color=#2196F3]Blue[/color]` 或 `[color=blue]`
`[b]`	Bold	`[b]Bold text[/b]`
`[i]`	Italic	`[i]Italic[/i]`
`[s]`	Strikethrough	`[s]deleted[/s]`
`[u]`	Underline	`[u]underlined[/u]`
`[quote]`	Quote block	`[quote]Content[/quote]`
`[code]`	Code block	`[code]code[/code]`
`[img]`	Image	`[img]url[/img]`
`[url]`	Link	`[url=link]text[/url]`
`[list]`	List container	`[list][*]item[/list]`
`[spoiler]`	Collapsible content	`[spoiler=标题]隐藏内容[/spoiler]`

HTML to BBCode Conversion

HTML Input	BBCode Output
`<mark>高亮</mark>`	`[color=yellow]高亮[/color]`
`<u>下划线</u>`	`[u]下划线[/u]`
`<details><summary>标题</summary>内容</details>`	`[spoiler=标题]内容[/spoiler]`

Unsupported Tags (Avoid!)

Tag	Reason	Alternative
`[align]`	Not rendered	Remove or use default left
`[hr]`	Shows as text	Use Markdown `---`
`<div>`	HTML not supported	Use BBCode only
`[table]`	Limited support	Use list or code block

Size Hierarchy (Pixels)

Element	Size	Color	Usage
Main Title	150	#2196F3	Document title
Section Title	120	#2196F3	Major sections (## H2)
Subsection	100	#333	Sub-sections (### H3)
Normal Text	(default)	-	Body content
Notes/Gray	80	gray	Footnotes, metadata

Color Palette

Color	Hex	Semantic Usage
Blue	#2196F3	Titles, links, info
Green	#4CAF50	Success, tips, features
Orange	#FF9800	Warnings, caution
Red	#F44336	Errors, danger, important
Purple	#9C27B0	Examples, code
Gray	gray	Notes, metadata

Mandatory Prerequisites

Read before execution:

Document	Purpose	Priority
specs/format-rules.md	Format conversion rules	P0
specs/element-mapping.md	Element type mappings	P1
specs/callout-types.md	Callout/Admonition types	P1

Execution Flow

┌────────────────────────────────────────────────────────────────┐
│  Phase 1: Input Collection                                      │
│  - Ask: paste text OR file path                                │
│  - Output: input-config.json                                   │
├────────────────────────────────────────────────────────────────┤
│  Phase 2: Content Analysis                                      │
│  - Detect structure: headings, lists, code blocks, tables      │
│  - Identify Callouts/Admonitions (>[!type])                    │
│  - Output: analysis.json                                       │
├────────────────────────────────────────────────────────────────┤
│  Phase 3: Format Transform                                      │
│  - Apply BBCode + MD rules from specs/format-rules.md          │
│  - Convert elements with pixel-based sizes                     │
│  - Use Markdown --- for separators                             │
│  - Output: formatted content                                   │
├────────────────────────────────────────────────────────────────┤
│  Phase 4: Output & Preview                                      │
│  - Save to .bbcode.txt file                                    │
│  - Display preview                                              │
│  - Output: final file                                          │
└────────────────────────────────────────────────────────────────┘

Callout/Admonition Support

支持 Obsidian 风格的 Callout 语法，转换为 BBCode quote：

> [!NOTE]
> 这是一个提示信息

> [!WARNING]
> 这是一个警告信息

转换结果：

[quote]
[size=100][color=#2196F3][b]📝 注意[/b][/color][/size]

这是一个提示信息
[/quote]

Type	Color	Icon
NOTE/INFO	#2196F3	📝
TIP/HINT	#4CAF50	💡
SUCCESS	#4CAF50	✅
WARNING/CAUTION	#FF9800	⚠️
DANGER/ERROR	#F44336	❌
EXAMPLE	#9C27B0	📋

Directory Setup

const timestamp = new Date().toISOString().slice(0,10).replace(/-/g, '');
const workDir = `.workflow/.scratchpad/text-formatter-${timestamp}`;

Bash(`mkdir -p "${workDir}"`);

Output Structure

.workflow/.scratchpad/text-formatter-{date}/
├── input-config.json       # 输入配置
├── analysis.json           # 内容分析结果
└── output.bbcode.txt       # BBCode+MD 输出

Reference Documents

Document	Purpose
phases/01-input-collection.md	收集输入内容
phases/02-content-analysis.md	分析内容结构
phases/03-format-transform.md	格式转换
phases/04-output-preview.md	输出和预览
specs/format-rules.md	格式转换规则
specs/element-mapping.md	元素映射表
specs/callout-types.md	Callout 类型定义
templates/bbcode-template.md	BBCode 模板

More by catlog22

View all

Prompt Enhancer

1,008

Transform vague prompts into actionable specs using intelligent analysis and session memory. Use when user input contains -e or --enhance flag.

ccw

1,008

Stateless workflow orchestrator. Auto-selects optimal workflow based on task intent. Triggers "ccw", "workflow".

1,008

Generate software copyright design specification documents compliant with China Copyright Protection Center (CPCC) standards. Creates complete design documents with Mermaid diagrams based on source code analysis. Use for software copyright registration, generating design specification, creating CPCC-compliant documents, or documenting software for intellectual property protection. Triggers on "软件著作权", "设计说明书", "版权登记", "CPCC", "软著申请".

issue-manage

1,008

Interactive issue management with menu-driven CRUD operations. Use when managing issues, viewing issue status, editing issue fields, performing bulk operations, or viewing issue history. Triggers on "manage issue", "list issues", "edit issue", "delete issue", "bulk update", "issue dashboard", "issue history", "completed issues".