Agent skill

Filename Convention

by mohitagw15856 in mohitagw15856/pm-claude-skills

Set a filename convention that sorts, searches, and survives — date-first ISO format, the descriptor grammar, version suffixes that end the FINAL-final2 era, and the rollout that gets a team…

MITAuto-check passed

Install Filename Convention

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill filename-convention -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills filename-convention --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/filename-convention .claude/skills/filename-convention && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
filename-convention
GitHub stars
1.4k
Token cost
~1.3k tokens
SKILL.md length
590 words
Files
1
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

Set a filename convention that sorts, searches, and survives — date-first ISO format, the descriptor grammar, version suffixes that end the FINAL-final2 era, and the rollout that gets a team…

  • Works in 5 steps: ISO date first (usually): 2026-07-19… → Fixed slot order, hyphen/underscore… → The version rule ends the FINAL era:… → …
  • Asked set up file naming rules
  • SKILL.md covers What This Skill Produces, Required Inputs, Framework: The Grammar Rules and Output Format, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Filename Convention is an agent skill from mohitagw15856/pm-claude-skills. Set a filename convention that sorts, searches, and survives — date-first ISO format, the descriptor grammar, version suffixes that end the FINAL-final2 era, and the rollout that gets a team actually using it. Use when asked set up file naming rules, our filenames are chaos, what should we call our files, or fix the v2-final-FINAL problem. Produces the convention with its grammar, examples for the team's real file types, the version rule, and the one-line cheat sheet.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Asked set up file naming rules
  • Our filenames are chaos
  • What should we call our files
  • Fix the v2-final-FINAL problem

Example prompts

  • “/filename-convention”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. ISO date first (usually): 2026-07-19 sorts correctly forever, is unambiguous across cultures, and makes every folder self-chronologizing…
  2. Fixed slot order, hyphen/underscore discipline: date_project_doctype_descriptor_version — underscores between slots, hyphens within them…
  3. The version rule ends the FINAL era: integers only (v1, v2), state tags where useful (v3-approved), and "final" is banned because it's a…
  4. Descriptors are for humans, dates are for machines: the descriptor slot answers "which one is this" in two-to-four words (board-pack…
  5. Rollout by usefulness, not mandate: rename the twenty most-touched files as the demonstration, post the one-liner, and apply the…

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Filename Convention loads about 1.3k tokens when it runs. Until then it costs about 123 tokens; SKILL.md has 590 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~123
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 590 words, ~1,250 tokens.

Download SKILL.mdSave it as .claude/skills/filename-convention/SKILL.md (or your agent's skills folder).
name
filename-convention
description
Set a filename convention that sorts, searches, and survives — date-first ISO format, the descriptor grammar, version suffixes that end the FINAL-final2 era, and the rollout that gets a team actually using it. Use when asked set up file naming rules, our filenames are chaos, what should we call our files, or fix the v2-final-FINAL problem. Produces the convention with its grammar, examples for the team's real file types, the version rule, and the one-line cheat sheet.

Filename Convention Skill

Report_final_v2_FINAL_johns-edits(2).docx is a filesystem crying for grammar. A working convention is small — date first in ISO form so files sort themselves, a few descriptor slots in fixed order, a version rule that bans "final" — and it's enforced by usefulness: names that sort chronologically and surface in search within seconds pay their own adoption. The convention fits on one line; everything longer goes unused.

What This Skill Produces

  • The grammar — the slot order (YYYY-MM-DD_project_doctype_descriptor_v2) tuned to the team's real files
  • Worked examples — the team's actual recent files, renamed per the grammar
  • The version rule — v1, v2, v3 + -draft/-approved states; "final" banned by decree with the reason
  • The one-line cheat sheet — the whole convention, postable in the folder guide

Required Inputs

Ask for these if not provided:

  • The file population — what the team actually produces (contracts, decks, exports, meeting docs); the grammar's slots come from what needs distinguishing
  • The sort need — chronological (date-first) vs. entity-first (acme_2026-07-19_... when browsing-by-client dominates); the retrieval pattern picks the lead slot
  • Cloud-doc reality — Google Docs/Notion pages need the convention too (titles are names); versioned-by-platform files relax the version suffix
  • The current chaos sample — a dozen real filenames; the before/after table is the convention's best salesman

Framework: The Grammar Rules

  1. ISO date first (usually): 2026-07-19 sorts correctly forever, is unambiguous across cultures, and makes every folder self-chronologizing. The one legitimate exception: entity-first when browsing-by-entity is the dominant retrieval — pick per the team's seek pattern, once.
  2. Fixed slot order, hyphen/underscore discipline: date_project_doctype_descriptor_version — underscores between slots, hyphens within them (acme-renewal). Fixed order means the eye parses filenames like a table; mixed order means reading every name in full.
  3. The version rule ends the FINAL era: integers only (v1, v2), state tags where useful (v3-approved), and "final" is banned because it's a prophecy, not a state — v4-final-final2 is the ban's justification, printed on the cheat sheet. Platform-versioned files (cloud docs) drop the suffix entirely; duplicating the platform's version history in names is noise.
  4. Descriptors are for humans, dates are for machines: the descriptor slot answers "which one is this" in two-to-four words (board-pack, signed-copy, eu-pricing) — jargon the team shares is fine; codes only the author knows are not.
  5. Rollout by usefulness, not mandate: rename the twenty most-touched files as the demonstration, post the one-liner, and apply the convention to everything new — old files get renamed when touched (the drain rule from folder-structure-designer). Mass-renaming breaks links; opportunistic renaming doesn't.
Show full SKILL.md (185 more words)Show less

Output Format

Filename Convention: [team]

The One-Liner (post this)

YYYY-MM-DD_project_doctype_descriptor_vN — underscores between slots, hyphens inside, ISO dates, integers for versions, "final" is banned.

Before / After

NowUnder the convention
[The team's real dozen, renamed]

Edge Rules

[Cloud docs: title = name, no version suffix · exports/receipts: date+source+period · the entity-first variant if chosen, with its why]

Quality Checks

  • The lead slot matches the team's dominant retrieval pattern
  • Slot order is fixed and separator discipline is stated
  • "final" is banned with its printed justification
  • Examples use the team's real files, not invented ones
  • Rollout is new-files-plus-drain, never mass rename

Anti-Patterns

  • Do not allow DD-MM vs MM-DD ambiguity — ISO or chaos, there is no third option
  • Do not encode what the folder already says — Clients/Acme/acme-acme-contract wastes a slot
  • Do not permit "final" even once — it's the gateway drug to FINAL-final2
  • Do not design slots for files the team doesn't produce — grammar bloat kills adoption
  • Do not mass-rename history — links break; the drain rule gets there without the breakage

Example Trigger Phrases

  • "Set up file naming rules."
  • "Our filenames are chaos."
  • "What should we call our files?"
  • "Fix the v2-final-FINAL problem."

© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/filename-convention of mohitagw15856/pm-claude-skills.

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Filename Convention next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Filename Convention compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Filename Convention this skillmohitagw15856/pm-claude-skills1.4k—~1.3kAutomated safety check: PassMIT
Searchdavila7/claude-code-templates33k—~339Automated safety check: PassMIT
X Search via xAIcode-yeongyu/oh-my-openagent70k—~1.4kAutomated safety check: PassCustom licence
Algolia Searchdavila7/claude-code-templates33k4 repos~492Automated safety check: PassMIT
Perplexity Web Searchdavila7/claude-code-templates33k11 repos~3.5kAutomated safety check: NotesMIT
Exa Neural Search via MCPaffaan-m/ECC277k4 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Search

    davila7/claude-code-templates

    Search Google via Bright Data SERP API. An agent skill from davila7/claude-code-templates.

    33k GitHub stars~339 tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • X Search via xAI

    code-yeongyu/oh-my-openagent

    Rules for using the x_search tool to search X (Twitter) through a connected xAI account: date-bound queries, trusted handles, search operators and split searches.

    70k GitHub stars~1.4k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Algolia Search

    davila7/claude-code-templates

    Expert patterns for Algolia search implementation, indexing strategies, React InstantSearch, and relevance tuning Use when: adding search to, algolia, instantsearch, search api, search functionality.

    33k GitHub starsUsed in 4 repos~492 tokens
    Backend & APIsAuto-check passed
  • Perplexity Web Search

    davila7/claude-code-templates

    Runs web-grounded searches through Perplexity's Sonar models over OpenRouter for current events, recent literature and cited facts beyond the model's training cutoff.

    33k GitHub starsUsed in 11 repos~3.5k tokens
    Research & ScienceAuto-check: notes
  • Searches the web, code, companies and people through the Exa MCP server, with notes on setup, the web_search_exa tool and treating results as untrusted data.

    277k GitHub starsUsed in 4 repos~1.1k tokens
    Productivity & AutomationAuto-check passed
  • Website Search

    thedaviddias/Front-End-Checklist

    A skill your agent uses when applies to sites with internal site search functionality.

    74k GitHub stars~556 tokensUpdated 5 days ago
    Marketing & SEOAuto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated 2 days ago
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed

Questions about Filename Convention

What does Filename Convention do?

Set a filename convention that sorts, searches, and survives — date-first ISO format, the descriptor grammar, version suffixes that end the FINAL-final2 era, and the rollout that gets a team…. Filename Convention is an agent skill from mohitagw15856/pm-claude-skills. Set a filename convention that sorts, searches, and survives — date-first ISO format, the descriptor grammar, version suffixes that end the FINAL-final2 era, and the rollout that gets a team actually using it.

When should I use Filename Convention?

Filename Convention fits situations like: asked set up file naming rules; our filenames are chaos; what should we call our files; fix the v2-final-FINAL problem.

How do I install Filename Convention in Claude Code?

Run `npx skills add mohitagw15856/pm-claude-skills --skill filename-convention -a claude-code`. Or copy the skill folder (skills/filename-convention in mohitagw15856/pm-claude-skills) into .claude/skills/filename-convention in your project. Claude Code loads it when a task matches its description.

How do I install Filename Convention in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill filename-convention -a codex`. Or copy the skill folder (skills/filename-convention in mohitagw15856/pm-claude-skills) into .agents/skills/filename-convention in your project. Codex loads it when a task matches its description.

Can I use Filename Convention in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill filename-convention -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/filename-convention, .gemini/skills/filename-convention, .github/skills/filename-convention and .opencode/skills/filename-convention in your project.

What does Filename Convention need to run?

SKILL.md names no scripts, command-line tools or credentials: Filename Convention is instructions for the agent only.

Does Filename Convention access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Filename Convention safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Filename Convention use?

Filename Convention is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Filename Convention use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Filename Convention?

Skills that share tags, products or a category with Filename Convention: Search (davila7/claude-code-templates, 33k stars), X Search via xAI (code-yeongyu/oh-my-openagent, 70k stars), Algolia Search (davila7/claude-code-templates, 33k stars) and Perplexity Web Search (davila7/claude-code-templates, 33k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Filename Convention?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,434 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 9, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.