Agent skill

Grammarly Document Evaluator

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Validate, plan, and explicitly execute Grammarly Writing Score, AI Detection, or Plagiarism Detection document jobs using the documented create, presigned upload, and poll lifecycle.

MITAuto-check passedBackend & APIs

Install Grammarly Document Evaluator

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill grammarly-document-evaluator -a claude-code

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace grammarly-document-evaluator --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/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/grammarly-document-evaluator .claude/skills/grammarly-document-evaluator && 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
grammarly-document-evaluator
GitHub stars
2.8k
Token cost
~1.6k tokens
SKILL.md length
608 words
Files
7 (incl. scripts, references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Validate, plan, and explicitly execute Grammarly Writing Score, AI Detection, or Plagiarism Detection document jobs using the documented create, presigned upload, and poll lifecycle.

  • Works in 8 steps: Classify the operation as writing-score,… → Run the helper without --execute from… → Review the endpoint, scopes, beta… → …
  • An operator needs to score a document
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Runs Python scripts from its folder; calls python3; needs GRAMMARLY_CLIENT_SECRET

What it does

Grammarly Document Evaluator is an agent skill from jeremylongshore/tons-of-skills-marketplace. Validate, plan, and explicitly execute Grammarly Writing Score, AI Detection, or Plagiarism Detection document jobs using the documented create, presigned upload, and poll lifecycle. Use when an operator needs to score a document, detect AI-generated content, check originality, diagnose a malformed document submission, or verify API result fields. Do not use for browser-editor grammar suggestions, live text rewriting, license deletion, or undocumented webhooks. Trigger with "score this document", "run Grammarly…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `eval-spec.yaml`, `references/api-contract.md` and `references/security-boundaries.md`). Compatibility notes: Agent Skills-compatible hosts; requires Python 3.10+

It sits in Backend & APIs, covering Humanizing AI text and Webhooks. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • An operator needs to score a document
  • Detect AI-generated content
  • Check originality
  • Diagnose a malformed document submission

Example prompts

  • “score this document”
  • “run Grammarly AI detection”
  • “check this document for plagiarism”
  • “/grammarly-document-evaluator”

Requirements

  • Python 3
  • A credential in GRAMMARLY_CLIENT_SECRET
  • Compatibility (from SKILL.md): Agent Skills-compatible hosts; requires Python 3.10+
  • Pre-approved tools (allowed-tools): Bash(python3:*)

Workflow steps

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

  1. Classify the operation as writing-score, ai-detection, or plagiarism.
  2. Run the helper without --execute from this skill directory
  3. Review the endpoint, scopes, beta marker, local constraints, retention boundary,
  4. Create a preliminary manifest with presigned_upload_origin: null and
  5. Put that exact sanitized origin and the dry-run metadata into the closed manifest
  6. If live transfer is authorized, execute with both bindings
  7. Treat COMPLETED and FAILED as terminal. A local polling-budget exhaustion means
  8. Interpret all score fields on the documented 0..1 scale. Never convert them into

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(python3:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    Links to these hosts (documentation or services it may open):

    • developer.grammarly.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GRAMMARLY_CLIENT_SECRET

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

  • Compatibility

    Agent Skills-compatible hosts; requires Python 3.10+

    From compatibility in the SKILL.md frontmatter.

Context cost

Grammarly Document Evaluator loads about 1.6k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 160 tokens; SKILL.md has 608 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~160
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.8k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 608 words, ~1,628 tokens.

Download SKILL.mdSave it as .claude/skills/grammarly-document-evaluator/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
grammarly-document-evaluator
description
Validate, plan, and explicitly execute Grammarly Writing Score, AI Detection, or Plagiarism Detection document jobs using the documented create, presigned upload, and poll lifecycle. Use when an operator needs to score a document, detect AI-generated content, check originality, diagnose a malformed document submission, or verify API result fields. Do not use for browser-editor grammar suggestions, live text rewriting, license deletion, or undocumented webhooks. Trigger with "score this document", "run Grammarly AI detection", "check this document for plagiarism", or "diagnose this Grammarly document job".
allowed-tools
Bash(python3:*)
compatibility
Agent Skills-compatible hosts; requires Python 3.10+
version
2.0.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
tags
saas, grammarly, document-analysis, security, operator-workflow

Grammarly Document Evaluator

Overview

Run Grammarly's three documented document APIs without inventing a direct-text endpoint. The helper is dry-run by default. Before upload, it can create a metadata-only request that reveals only the sanitized presigned origin for approval. Inspection requires an INSPECTION_READY manifest before OAuth. Live execution requires an exact digest and a READY closed-schema safety manifest bound to the operation, bytes, and both destinations. It reads OAuth credentials only from the process environment, bounds polling locally, and emits no token, full upload URL, raw request identifier, or document text.

Prerequisites

  • Grammarly Enterprise or an institution-wide Grammarly for Education license with API access.
  • Python 3.10 or newer.
  • One supported regular, non-symlink file: .doc, .docx, .odt, .txt, or .rtf.
  • For live execution only, GRAMMARLY_CLIENT_ID and GRAMMARLY_CLIENT_SECRET in the environment.
  • The exact read/write scopes for the selected operation; see API contract.

Instructions

  1. Classify the operation as writing-score, ai-detection, or plagiarism.

  2. Run the helper without --execute from this skill directory:

    bash
    python3 scripts/run_document_evaluation.py \
      --operation writing-score \
      --file /approved/input/document.txt
  3. Review the endpoint, scopes, beta marker, local constraints, retention boundary, and content_sha256. A dry run does not contact Grammarly.

  4. Create a preliminary manifest with presigned_upload_origin: null and presigned_upload_origin_approved: false. Continue only when the safety guardian returns INSPECTION_READY, then inspect the actual byte destination. This creates a provider request but performs no upload and emits no signed URL:

    bash
    python3 scripts/run_document_evaluation.py \
      --operation writing-score \
      --file /approved/input/document.txt \
      --inspect-upload-origin \
      --confirm-content-sha256 sha256:REVIEWED_DIGEST \
      --approval-manifest /approved/metadata/grammarly-inspection.json
  5. Put that exact sanitized origin and the dry-run metadata into the closed manifest for grammarly-data-safety-guardian. Continue only when it returns READY.

  6. If live transfer is authorized, execute with both bindings:

    bash
    python3 scripts/run_document_evaluation.py \
      --operation writing-score \
      --file /approved/input/document.txt \
      --execute \
      --confirm-content-sha256 sha256:REVIEWED_DIGEST \
      --approval-manifest /approved/metadata/grammarly-transfer.json
  7. Treat COMPLETED and FAILED as terminal. A local polling-budget exhaustion means only that this helper stopped; Grammarly documents no processing-time SLA.

  8. Interpret all score fields on the documented 0..1 scale. Never convert them into unsupported pass/fail policy unless the operator supplies that policy separately.

Output

  • Dry run: a JSON transfer plan with content digest, byte size, extension, endpoint, scopes, beta status, and documented retention boundaries.
  • Upload-origin inspection: sanitized public HTTPS origin, hashed request identifier, hashed full URL, and document_uploaded: false; the signed path/query remains secret.
  • Execute: the same plan plus approved origin, hashed request identifier, terminal status, and exact API-specific score fields when completed.
  • No raw content, OAuth token, client secret, presigned URL, or raw provider body.
Show full SKILL.md (239 more words)Show less

Error Handling

FailureMeaningSafe response
Unsupported, empty, oversized, symlinked, or changing fileLocal safety check failedStop and prepare a new approved regular file.
Fewer than 30 words or more than 100,000 UTF-8 characters in .txtDocumented text constraint failedCorrect the source; do not split and recombine scores.
Digest confirmation mismatchReviewed bytes differ from execution bytesStop and repeat dry run and approval.
Missing, blocked, or mismatched approval manifestGovernance decision does not bind this operation, content, phase, or originStop before OAuth or before upload.
Newly issued upload origin differs from the approved inspected originProvider byte destination changedStop before PUT; inspect and approve again.
OAuth or API HTTP failureProvider boundary rejected the operationReport only phase and status code; never dump bodies or credentials.
Unknown status or result fieldResponse differs from the pinned contractFail closed and verify current official documentation.
Polling budget exhaustedLocal cap reached; provider limit is undocumentedReturn deferred/unknown, never fabricate a score.

Examples

AI detection request: choose ai-detection, disclose that it is Beta, require ai-detection-api:read,write, and return only average_confidence and ai_generated_percentage on a 0..1 scale.

“Send this paragraph directly to /v1/check”: refuse that contract. Grammarly's document APIs require a filename-only creation body, a presigned file upload, and status polling.

Provider outage: return an explicit unavailable or deferred result. Never substitute an invented score.

Resources

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

Files

SKILL.md and 6 other files (scripts, references) in skills/.curated/grammarly-document-evaluator of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • eval-spec.yaml
  • references/api-contract.md
  • references/security-boundaries.md
  • scripts/audit_submission_manifest.py
  • scripts/grammarly_api.py
  • scripts/run_document_evaluation.py

Open the folder on GitHubat commit cfae287

Compare with similar skills

Grammarly Document Evaluator 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.

Grammarly Document Evaluator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Grammarly Document Evaluator this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.6kAutomated safety check: PassMIT
Novu Design Workflownovuhq/novu40k—~2.6kAutomated safety check: PassCustom licence
Golivemikehasa/golive-skill1.3k—~13kAutomated safety check: NotesMIT
Stripe Appsfossasia/eventyay1.7k1 repos~3.6kAutomated safety check: PassApache-2.0
Dingtalk Messageagentscope-ai/ReMe3.6k—~1.6kAutomated safety check: PassApache-2.0
PR Review Provideryansongda/pay5.4k—~2.4kAutomated safety check: PassMIT

Similar skills

  • Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state.

    40k GitHub stars~2.6k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Golive

    mikehasa/golive-skill

    Take an agent-written app from repo to live production on the user's OWN accounts, with providers they choose (hosting, database, auth, payments, email, domain/DNS).

    1.3k GitHub stars~13k tokensUpdated 7 days ago
    Backend & APIsAuto-check: notes
  • Stripe Apps

    fossasia/eventyay

    A skill your agent uses when building, modifying, or reviewing a Stripe App — or when the user describes something that implies one (e.g.

    1.7k GitHub starsUsed in 1 repo~3.6k tokens
    Backend & APIsAuto-check passed
  • Dingtalk Message

    agentscope-ai/ReMe

    钉钉消息发送技能。支持企业内部机器人(批量单聊/群聊)和 Webhook 自定义机器人两种接入方式,支持多机器人管理,支持文本、Markdown、链接、ActionCard、FeedCard等多种消息类型。

    3.6k GitHub stars~1.6k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • PR Review Provider

    yansongda/pay

    A skill your agent uses when reviewing PRs that add or modify a payment Provider in yansongda/pay - covers plugin pipeline, multi-tenant safety, signature verification, docs, and naming conventions.

    5.4k GitHub stars~2.4k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Stripe Best Practices

    kanchengw/cnllm

    Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial…

    173 GitHub starsUsed in 2 repos~925 tokens
    Backend & APIsAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about Grammarly Document Evaluator

What does Grammarly Document Evaluator do?

Validate, plan, and explicitly execute Grammarly Writing Score, AI Detection, or Plagiarism Detection document jobs using the documented create, presigned upload, and poll lifecycle. Grammarly Document Evaluator is an agent skill from jeremylongshore/tons-of-skills-marketplace. Validate, plan, and explicitly execute Grammarly Writing Score, AI Detection, or Plagiarism Detection document jobs using the documented create, presigned upload, and poll lifecycle.

When should I use Grammarly Document Evaluator?

Grammarly Document Evaluator fits situations like: an operator needs to score a document; detect AI-generated content; check originality; diagnose a malformed document submission.

How do I install Grammarly Document Evaluator in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill grammarly-document-evaluator -a claude-code`. Or copy the skill folder (skills/.curated/grammarly-document-evaluator in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/grammarly-document-evaluator in your project. Claude Code loads it when a task matches its description.

How do I install Grammarly Document Evaluator in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill grammarly-document-evaluator -a codex`. Or copy the skill folder (skills/.curated/grammarly-document-evaluator in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/grammarly-document-evaluator in your project. Codex loads it when a task matches its description.

Can I use Grammarly Document Evaluator 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 jeremylongshore/tons-of-skills-marketplace --skill grammarly-document-evaluator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/grammarly-document-evaluator, .gemini/skills/grammarly-document-evaluator, .github/skills/grammarly-document-evaluator and .opencode/skills/grammarly-document-evaluator in your project.

What does Grammarly Document Evaluator need to run?

Going by SKILL.md and its folder, Grammarly Document Evaluator needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named GRAMMARLY_CLIENT_SECRET. Our summary lists: Python 3; A credential in GRAMMARLY_CLIENT_SECRET. Its frontmatter pre-approves these tools: Bash(python3:*). Compatibility (from SKILL.md): Agent Skills-compatible hosts; requires Python 3.10+.

Does Grammarly Document Evaluator access the network?

SKILL.md names 1 domain. As links in the text: developer.grammarly.com. This is read from the text; nothing was executed.

Is Grammarly Document Evaluator 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Grammarly Document Evaluator use?

Grammarly Document Evaluator is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Grammarly Document Evaluator use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Grammarly Document Evaluator?

Skills that share tags, products or a category with Grammarly Document Evaluator: Novu Design Workflow (novuhq/novu, 40k stars), Golive (mikehasa/golive-skill, 1.3k stars), Stripe Apps (fossasia/eventyay, 1.7k stars) and Dingtalk Message (agentscope-ai/ReMe, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Grammarly Document Evaluator?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

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