# Telegram Contract Ops

> Telegram Contract Ops

- Skill: `cslawyer1985/telegram-contract-ops` (Agent Skill, multi-file: 15 files)
- Install (CLI): `npx skillmds@latest add cslawyer1985/telegram-contract-ops`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cslawyer1985/telegram-contract-ops/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cslawyer1985 (https://skillmd.com/u/cslawyer1985)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cslawyer1985/telegram-contract-ops

---


# Telegram Contract Ops

Use this skill for the combined Plan B + Plan C workflow.

## What this skill covers

- Parse standardized Telegram text blocks into contract data
- Generate `.docx` contracts from a company template
- Run Telegram bot flows for `/mauhopdong`, `/cccd`, `/cccd_debug`
- OCR Vietnamese electronic ID screenshots and convert them into Plan B input blocks
- Route contract behavior by Telegram group

## Current design boundary

### Plan B
- Input: structured Telegram-style `KEY: VALUE` block
- Output: `.docx` contract file

### Plan C
- Input: 1 screenshot of Vietnamese electronic ID from app
- OCR output fields:
  - `TEN`
  - `NGAY_SINH`
  - `CCCD`
  - `NGAY_CAP`
  - `THUONG_TRU`
  - `CHO_O_HIEN_TAI` when available
- Hardcode:
  - `NOI_CAP = CTCCS QLHC VTTXH`
- User confirms/edits block before final contract generation

## Keep these outside the packaged skill
- Telegram bot token
- group chat IDs
- `.env.telegram`
- `.env.telegram.groups`
- OCR debug session artifacts
- state files and logs

## Included references
- `references/architecture.md` - flow overview and routing
- `references/deployment.md` - migration/install checklist
- `references/input-template.md` - canonical Telegram input block
- `references/clawhub.md` - publish/install/update commands via ClawHub
- `references/troubleshooting.md` - common runtime and routing issues
- `references/windows.md` - Windows-specific guidance
- `references/macos.md` - macOS-specific guidance

## Included assets/scripts
Read these only when needed:
- `scripts/` for generator/parser/bot helpers
- `assets/` for original `.docx` template
- `assets/windows/` for Windows example env files and quick-start PowerShell wrapper