agentleFS
fliqrlabsfliqrlabs/instagram-creator-skills/skills/polish/SKILL.md

polish

Skill5 starsChanged 18 days agoMITView on GitHub

Strip the AI fingerprint from creator copy and lint it before it ships: removes invisible characters, em dashes, curly quotes and stock AI phrases, flags robotic sentence shapes for a rewrite, and checks captions (feed fold, 5-hashtag cap, keyword position), hooks (scored), reel scripts (timed beat sheet) and DMs (Instagram limits). Use when the creator says "make it sound human", "this sounds like AI", "humanize", "check my caption", "proofread this", "is this ready to post", and before any other skill in this pack hands over final copy.

70 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use layout, shape and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • owshq-mecSkill

    layout

    Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy. Use when the user mentions layout feeling off, spacing issues, visual hierarchy, crowded UI, alignment problems, or wanting better composition.

    Also in 8 projects that use this

  • HAR5HA-7663Skill

    shape

    Plan the UX and UI for a feature before writing code. Runs a structured discovery interview, then produces a design brief that guides implementation. Use during the planning phase to establish design direction, constraints, and strategy before any code is written.

    Also in 13 projects that use this

  • PeterCangSkill

    tokens

    Count all historical Claude Code token usage across all local projects, broken down by model, project, date, and week. Includes cost estimation based on official Anthropic pricing.

    Also in 3 projects that use this

  • arjunkshahSkill

    redesign

    Redesign existing interfaces to premium quality while preserving product goals and functional behavior.

    Also in 3 projects that use this

  • leonaaardobSkill

    motion

    Complete Motion.dev documentation - modern animation library for React, JavaScript, and Vue (formerly Framer Motion)

    Also in 3 projects that use this

  • MicrosoftSkill

    review-loop

    Iterative review loop using any lens agent against any target (plan, code, design). Use when you want to run a focused review cycle: spawn a fresh reviewer subagent with a specific lens, present findings and remediation to the user, apply fixes with user guidance, and repeat until clean.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 4 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 62 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    No Python available (for example in a plain chat)?

    line 41
  2. Distinctive:

    Don't swap a synonym in. Rewrite the sentence the way the creator would say it out loud:

    line 54
  3. Distinctive:

    Put a concrete thing (number, name, place, object) where the abstraction was.

    line 56
  4. Distinctive:

    Use the creator's own phrases from their profile.

    line 57
  5. Distinctive:

    Read it aloud. If they'd never say it on camera, it's not done.

    line 58

“Common” is measured: kept by at least 6 in 10 of the 62 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

polish

AI-written captions read the same: em dashes, "unlock", "game-changer", "it's not just X, it's Y", and the same rhythm in every line. Audiences notice in a second. This skill cleans what can be cleaned automatically and flags the rest for a human-quality rewrite.

Commands use python3. On Windows, use python.

The tool

scripts/polish.py. Standard-library Python, runs offline, nothing is uploaded.

python3 scripts/polish.py draft.txt                      # caption lint (default)
python3 scripts/polish.py hooks.txt --mode hook          # rank hooks, one per line
python3 scripts/polish.py script.txt --mode script --target 30   # [0:03] timestamps are fine
python3 scripts/polish.py bio.txt --mode bio                       # 150-char limit, CTA, proof
python3 scripts/polish.py dm.txt --mode dm
python3 scripts/polish.py draft.txt --fix                # also print the cleaned text
echo "one line" | python3 scripts/polish.py - --mode hook

Exit code 0 PASS, 1 WARN, 2 FAIL, so it works as a pre-publish gate in scripts. The word lists live in scripts/rules.json. Creators and agencies should edit them: add your own banned words, or remove one your niche genuinely uses.

No Python available (for example in a plain chat)? Apply the same rules by hand from rules.json and say that the tool wasn't run.

What it does

Fixes automatically: zero-width and other invisible characters, odd spaces, em dash → comma, en dash → hyphen, curly → straight quotes, the "…" character → "...", and filler phrases ("in order to" → "to", "utilize" → "use").

Flags for rewrite (needs judgement):

  • the stock AI phrases list (delve, unlock, elevate, game-changer, seamless, landscape…)
  • creator clichés: stop scrolling, hey guys, follow for more, tag a friend who, link in bio
  • shapes: "it's not just X, it's Y", tidy rule-of-three endings, emoji bullet lists, three SHOUTED words in a row, "The result?" setups, hashtag walls

How to rewrite a flagged line

Don't swap a synonym in. Rewrite the sentence the way the creator would say it out loud:

  • Make it shorter. Break the rhythm: mix 3-word lines with 12-word lines.
  • Put a concrete thing (number, name, place, object) where the abstraction was.
  • Use the creator's own phrases from their profile.
  • Read it aloud. If they'd never say it on camera, it's not done.

Honest limits

These are local heuristics modelled on what readers and detectors notice. They are not an AI-detector service and can't promise any detector's verdict. Nobody can honestly promise "undetectable". The hook scorer catches bad hooks well and can't tell you which of two good hooks will win. Only posting does that.

<!-- brand:footer -->

Part of Instagram Creator Skills by Fliqr AI. Live Instagram data and comment-to-DM automations come from the Fliqr AI connector (fliqr.ai).

<!-- /brand:footer -->

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.