Grammar And Mechanics logo

Grammar And Mechanics

Community
fatihguner
grammar-and-mechanics

Provides a structured reference for the grammar and punctuation rules that most frequently undermine credibility in business writing. Covers subject-verb agreement, pronoun case, dangling modifiers, parallel construction, comma splices, and the most common usage confusions (affect/effect, that/which, who/whom). Use when proofreading pitch decks, investor updates, client proposals, or any external-facing document where a single error can erode perceived competence.

Overview

Publisherfatihguner
Repositoryforeman
Skill namegrammar-and-mechanics
Stars
63
Forks
10
Bundled files
Instructions only
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by fatihguner on GitHub. Read the source before you install it.

Installation

Install the Grammar And Mechanics AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/fatihguner/foreman/tree/main/plugins/foreman/skills/grammar-and-mechanics
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/fatihguner/foreman.git /tmp/foreman
mkdir -p .claude/skills
cp -r /tmp/foreman/plugins/foreman/skills/grammar-and-mechanics .claude/skills/grammar-and-mechanics
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Grammar And Mechanics in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Grammar And Mechanics on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Grammar And Mechanics is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Read runtime and advisory rules before applying this skill. Other Foreman layers and the catalog are in ../../content/, relative to this SKILL.md.

Grammar and Mechanics

A misplaced apostrophe has never killed a company. But it has killed pitch decks, alienated investors, and quietly disqualified founders from rooms they never knew they were being evaluated for. Grammar errors in business writing operate as a credibility tax: each one individually minor, collectively devastating. Readers may not consciously register the error, but they register its effect -- a subtle downgrade in how seriously they take the author. The founder who writes "it's revenue model" instead of "its revenue model" in a Series A memo has communicated something unintended: carelessness with details. And carelessness with details is precisely the trait investors screen for.

The rules that follow are not pedantic niceties. They are the twelve grammatical principles and twelve punctuation conventions that, when violated, most reliably damage professional credibility.


The Framework

Twelve Essential Grammar Rules

1. Starting sentences with And or But is perfectly acceptable. The myth persists from secondary school, but the best prose writers have always done it. Monosyllabic conjunctions create tighter transitions than however or additionally.

2. Ending a sentence with a preposition is fine. The prohibition traces to Latin syntax and has no basis in English grammar. "What will the new product be used for?" reads more naturally than the contorted alternative.

3. Use well as an adverb, not good. "The team performed well" -- not "performed good." The exception: set phrases like "a good many" or "did it but good."

4. The subject determines the verb's number. Prepositional phrases that follow the subject create "false attraction" -- the verb should match the subject, not the nearest noun.

  • Wrong: "The details of the customized work is delaying the project."
  • Right: "The details of the customized work are delaying the project."

5. Either and neither as subjects take singular verbs. "Neither of our expansion options provides a total solution" -- not provide.

6. With neither/nor and either/or, the second element controls the verb. "Neither the regional managers nor the vice-president likes the proposed theme."

7. Flat adverbs (thus, doubtless) take no -ly ending. Adding -ly to words that are already adverbs produces nonstandard forms: thusly and doubtlessly are both incorrect.

8. Conjunctive adverbs (however, therefore) cannot join independent clauses with just a comma. This produces the comma splice. Use a semicolon before and a comma after: "The campaign is ready; however, the CEO has yet to approve it."

9. That introduces restrictive clauses (no comma); which introduces non-restrictive clauses (with a comma). "The report that you requested is ready" vs. "The report, which you requested, is ready."

10. Pronouns must agree with their antecedents in number. "A shareholder may cast his or her vote" -- or restructure the sentence to use the plural: "Shareholders may cast their votes."

11. Avoid double negatives. Subtle forms include couldn't scarcely (use could scarcely) and not...but constructions that create ambiguity.

12. Use standard English consistently. Watch for nonstandard forms that creep in from speech: shouldn't of (should be shouldn't have), drug as past tense of drag (should be dragged).

Twelve Punctuation Essentials

#RuleExample
1Use the serial (Oxford) comma before the final item in a list"Revenue, costs, and margins"
2Place commas and periods inside quotation marksShe said "the deal is closed."
3Use a semicolon to join related independent clauses"Sales rose 14%; margins held steady."
4Use a colon to introduce a list, explanation, or elaboration"Three priorities: hiring, retention, and culture."
5Hyphenate compound adjectives before a noun"A well-written proposal" (but "the proposal was well written")
6Use an em dash for emphasis or interruption"The acquisition -- if approved -- will close in Q3."
7Apostrophes show possession, not plurality"The company's revenue" not "the company's revenue's"
8Its (possessive) vs. it's (contraction of "it is")"The firm increased its revenue"
9Use parentheses for supplementary information"Revenue ($4.2M) exceeded projections."
10End declarative sentences with a single periodNever use double periods or exclamation marks in formal prose
11Use a comma after introductory phrases"After reviewing the data, the team recommended expansion."
12Do not use a comma to separate a subject from its verbWrong: "The CEO, approved the budget."

Common Usage Confusions

Confused PairDistinction
affect / effectAffect is usually a verb (to influence); effect is usually a noun (a result). "The policy will affect margins. The effect will be significant."
that / whichThat restricts; which adds information. Use which with commas.
who / whomWho is the subject; whom is the object. Test: substitute he/him. "Who called?" (he called). "To whom was it sent?" (sent to him).
fewer / lessFewer for countable nouns; less for uncountable. "Fewer employees, less revenue."
comprise / composeThe whole comprises its parts. The parts compose the whole. "The board comprises seven members."
ensure / insureEnsure means to make certain; insure relates to insurance policies.
principal / principlePrincipal is a leader or primary; principle is a fundamental rule.

Prompts

Prompt 1 -- Grammar Audit:

Review the following business document for grammar errors, focusing on subject-verb agreement, pronoun case, dangling modifiers, and parallel construction. For each error found, quote the original sentence, explain the specific rule violated, and provide a corrected version. Document: [paste text]

Prompt 2 -- Usage Confusion Scan:

Examine this text for commonly confused words (affect/effect, that/which, who/whom, fewer/less, comprise/compose, ensure/insure, principal/principle). Flag every instance, explain whether it is used correctly, and suggest corrections where needed. Text: [paste text]

Prompt 3 -- Punctuation Overhaul:

Audit this document for punctuation errors, paying special attention to comma splices, missing serial commas, incorrect apostrophe usage, and hyphenation of compound adjectives. Provide a corrected version with annotations explaining each change. Document: [paste text]

Prompt 4 -- Before/After Credibility Rewrite:

Here is a paragraph from an investor update I am preparing: [paste text]. Rewrite it to eliminate all grammar and punctuation errors while preserving the original meaning and tone. Then list every change made and the rule that motivated it.


Use Cases

Validation-Stage Founder Preparing a Pitch Deck A solo founder preparing a twelve-slide seed pitch discovers, after a grammar audit, that three slides contain subject-verb disagreements and one uses "it's" as a possessive. The investor reading the deck is a former English major who served as managing editor of the Stanford Law Review. These errors would have been the first -- and possibly the last -- things noticed. The grammar check costs fifteen minutes. The unchecked alternative could have cost the meeting.

Growth-Stage Company Publishing an Annual Report A 200-person company preparing its first public annual report submits the draft for a grammar and mechanics review. The audit catches 23 punctuation inconsistencies (mixed usage of serial commas), 7 that/which confusions, and a dangling modifier in the CEO's letter that accidentally attributes declining margins to the board of directors rather than to market conditions. The corrected version avoids an embarrassment that, once printed and distributed, could not be recalled.

Early-Traction Startup Drafting Client Contracts A B2B SaaS startup discovers its standard client proposal template contains "less" where "fewer" is required, inconsistent hyphenation of compound modifiers, and three instances of comma splices. Since this template has been sent to forty prospects over six months, the cumulative credibility impact is sobering. Correcting the template takes twenty minutes and elevates the professionalism of every future client interaction.


Anti-Patterns

  1. Hypercorrection. Overcorrecting grammar to the point of producing stilted, unnatural prose. Writing "to whom should I direct this inquiry?" in a Slack message to a colleague is technically correct and socially absurd. The goal is correctness appropriate to context, not grammatical maximalism.

  2. Grammar Policing in Feedback. Using grammar knowledge to publicly correct colleagues' writing rather than privately and constructively improving shared documents. Grammar competence used as a status signal breeds resentment, not better writing.

  3. Ignoring Grammar in Internal Documents. Treating grammar as relevant only for external communications. Internal memos, Slack messages, and team updates also shape how people perceive competence. Sloppy internal writing creates sloppy habits that leak into external documents at the worst moments.

  4. Relying Solely on Spell-Checkers. Spell-check tools catch "teh" but miss "their" when you meant "there." Grammar-checking software has improved but still mishandles subject-verb agreement in complex sentences, that/which distinctions, and subtle comma splices. Automated tools supplement human review; they do not replace it.

  5. Perfectionism as Procrastination. Endless grammar revision as a means of avoiding the more difficult work of actually saying something. A grammatically perfect document that says nothing of substance is a polished void.


By Stage

StageFocusKey Difference
IdeaPersonal credibility in initial pitchesAt the idea stage, the founder is the product. Grammar errors in early pitch materials disproportionately damage credibility because there is no product traction to compensate.
ValidationPitch decks and investor communicationsDocuments begin circulating to external audiences -- investors, advisors, potential partners. Every document is evaluated as evidence of operational competence.
Early TractionClient-facing proposals and contractsProposals, contracts, and onboarding materials now represent the company to paying customers. Grammar errors signal carelessness in a context where trust is still fragile.
GrowthStandardising templates and style guidesWith multiple people writing on behalf of the company, inconsistency becomes the primary risk. A company-wide style guide and grammar checklist become organisational infrastructure.
ScaleBrand consistency across all communicationsAt scale, grammar and mechanics become part of brand management. Training programmes, editorial review processes, and style enforcement tools ensure consistency across hundreds of authors.

Output Template

markdown
# Grammar and Mechanics Audit: [Document Name]

## Summary
- **Total errors found:** [number]
- **Critical errors (meaning-altering):** [number]
- **Credibility errors (noticeable but not meaning-altering):** [number]
- **Style inconsistencies:** [number]

## Error Log

| # | Original Text | Error Type | Rule Violated | Corrected Text |
|---|--------------|------------|---------------|----------------|
| 1 | [quote] | [grammar/punctuation/usage] | [specific rule] | [corrected version] |
| 2 | [quote] | [grammar/punctuation/usage] | [specific rule] | [corrected version] |

## Recurring Patterns
- [Pattern 1: e.g., "Consistent misuse of that/which throughout"]
- [Pattern 2: e.g., "Serial comma used inconsistently"]

## Recommendations
1. [Specific recommendation for preventing recurrence]
2. [Style guide addition suggested]

Related Skills

  • Tone and Engagement -- Correct grammar is necessary but not sufficient; tone determines whether technically correct prose actually connects with readers.
  • Writing Effective Emails -- Email is the most frequent venue for grammar errors because speed and informality lower the writer's guard.
  • Writing Memos and Reports -- Formal documents demand the highest standard of grammatical precision because they persist in the organisational record.
  • Writing Performance Reviews -- Performance evaluations carry legal implications, making grammatical precision not merely a matter of style but of institutional risk.
  • Revising and Editing -- The editing pass is where grammar errors are caught systematically rather than relying on instinct during drafting.
  • Plain Language and Flow -- Many grammar errors stem from overly complex sentence constructions; plain language reduces the surface area for mechanical mistakes.

Frequently asked questions

What does the Grammar And Mechanics AI skill do?

Provides a structured reference for the grammar and punctuation rules that most frequently undermine credibility in business writing. Covers subject-verb agreement, pronoun case, dangling modifiers, parallel construction, comma splices, and the most common usage confusions (affect/effect, that/which, who/whom). Use when proofreading pitch decks, investor updates, client proposals, or any external-facing document where a single error can erode perceived competence.

Why use Grammar And Mechanics on TypingMind?

Because you install it once and use it with any model. Grammar And Mechanics is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Grammar And Mechanics in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/fatihguner/foreman/tree/main/plugins/foreman/skills/grammar-and-mechanics. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Grammar And Mechanics?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Grammar And Mechanics?

As many as you like. As long as a model supports skills, you can use Grammar And Mechanics with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Grammar And Mechanics AI skill free?

Yes. It is published on GitHub by fatihguner under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇