# Capel Fit

> Normalize and fit text to a strict character limit and target band using deterministic scripts. Use this utility skill for per-entry CAPEL length control in Admin Profiles and qualification answers. Use when this capability is needed.

- Skill: `tomevault-io/capel-fit` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/capel-fit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/capel-fit/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/capel-fit

---


# capel-fit

## Purpose

This skill provides **deterministic, post-generation** character counting
and adjustment utilities. It is the second half of the CAPEL length
control system:

1. **Internal CAPEL (LLM-side):** During drafting, the LLM uses a word
   budget countdown to approximate the target length. This technique is
   defined in `apex-guardrails` under "Internal CAPEL Generation
   Technique."
2. **capel-fit scripts (this skill):** After the LLM finishes drafting,
   these Python scripts validate the exact character count and apply
   deterministic compression or expansion to fit the text within the
   target band. Scripts guarantee precise counts and reproducible
   behavior.

Generation skills should: *"Draft using internal CAPEL word budget, then
validate with `capel-fit` scripts."*

## Inputs

Provide:

- `CHAR_LIMIT`: maximum characters allowed (with spaces).
- `TARGET_LOW`: lower bound of the desired character band.
- `TARGET_HIGH`: upper bound of the band (≤ CHAR_LIMIT).
- `WORD_TARGET` (optional): internal word budget hint.
- The text to be fitted (via stdin).

## Default behavior

Run the scripts to normalize punctuation and whitespace, count
characters and, if needed, apply conservative compression or expansion
heuristics. The scripts aim to fit the text within the target band and
never exceed the character limit. They use placeholders to expand
under‑length text when needed.

## Scripts

This skill includes a `scripts/` directory with:

* `normalize_text.py`: converts fancy punctuation to ASCII,
  collapses whitespace and strips leading/trailing spaces.
* `charcount.py`: counts characters (with spaces) after optional
  normalization.
* `fit_entry.py`: validates and optionally auto‑adjusts text to fit
  the specified limits. In auto mode, it applies conservative
  compression (phrase replacements, filler word removal) or expansion
  (adding placeholders) until the text fits.

## Usage

Invoke this skill when a text block must be fitted to strict
character limits, such as Admin Profile entries or qualification
answers. After manual drafting in another skill, call `capel-fit` to
validate and adjust the text. Do not use it to generate new
substantive content.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/yutsukioka) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->