ThoughtCodec is a bilingual, open-source skill library for turning abstract human intent into executable AI workflows, then compressing repeated practice back into reusable skills.
中文说明请见 README.zh-CN.md.
- SkillHub - install the published
thought-codecskill.
Most AI workflows still treat models as tools that answer isolated questions. ThoughtCodec treats AI collaboration as a two-way codec:
- Decompression: expand high-density ideas, strategies, and constraints into plans, SOPs, code structures, diagrams, and execution checklists.
- Compression: extract reusable rules from corrections, logs, repeated decisions, and finished work, then turn them into durable skills.
The project starts from five practical skills for Codex, Claude, and similar agentic assistants.
| Skill | Type | Use it when you need to |
|---|---|---|
| Architecture Scaffolding | Decompression | Convert business logic into architecture, data models, API contracts, and code structure. |
| SOP Instantiation | Decompression | Convert a broad goal into a concrete operating procedure with milestones and checks. |
| Rule & Prompt Optimizer | Compression | Convert feedback, corrections, and conversation traces into reusable prompt rules. |
| Code Abstraction & Encapsulation | Compression | Convert repeated or messy code into reusable components and engineering rules. |
| Personal Methodology Engine | Loop | Combine decompression and compression into a personal working-system loop. |
Each skill has an English and Simplified Chinese version:
skills/<skill-id>/SKILL.md
skills/<skill-id>/SKILL.zh-CN.md
Each skill also includes a practical example under skills/<skill-id>/examples/.
ThoughtCodec uses three shared building blocks:
.
|-- assets/ # Logo, banner, diagrams, and social preview images
|-- catalog/ # Machine-readable bilingual skill index
|-- docs/
| |-- en/ # English project documentation
| `-- zh-CN/ # Simplified Chinese project documentation
|-- examples/ # Cross-skill workflow examples
|-- scripts/ # Validation and maintenance scripts
`-- skills/ # One folder per skill
- Pick the skill that matches your task.
- Read the English or Chinese
SKILLfile. - Paste the skill instructions into Codex, Claude, or another agentic assistant.
- Provide the required inputs.
- Review the output, then record useful corrections for future compression.
Run the repository check locally:
bash scripts/validate_structure.shThis repository includes reusable open-source project visuals:
- Logo
- README banner
- Social preview
- Upload-ready social preview PNG
- Monochrome logo
- Architecture diagram
- Decompression and compression diagram
- Agentic loop diagram
ThoughtCodec is currently an initial public preview. The structure, first five preview-status skills, bilingual documentation, examples, visual assets, and validation script are in place. Future work can add integrations, tests, and more domain-specific skills.
Released under the MIT License.