services.devDocs

description_too_long

The running jobjob_7Hq2 · delivered · document.fr-CA.pdf · $49.00 charged

The tool description is over 30 words, so agents skim past it.

FixFails inExit
Shorten description.services/translation.ts1

Owned by Your own Service: the page that explains what this gate holds.

What check says

npx services.dev check
  ✗ The tool description is over 30 words, so agents skim past it. Shorten description: the tool description is 36 words.
    https://services.dev/docs/reference/check/description_too_long
✗ 1 to fix

The failing file

services/translation.ts
import { Service } from 'services.dev'

export default Service({
  name: 'Translation',
  description: 'Any contract, filing or certificate, in any language a buyer names, translated with its layout, tables, stamps and footnotes kept where they were.',
  input: { document: 'file', to: 'language: a BCP 47 tag, such as fr-CA' },
  output: { document: 'file' },
  price: 49,
})

The fix

git add -A && git diff --staged
diff --git a/services/translation.ts b/services/translation.ts
index 8b9cbe3..6e3c106 100644
--- a/services/translation.ts
+++ b/services/translation.ts
@@ -2,7 +2,7 @@ import { Service } from 'services.dev'
 
 export default Service({
   name: 'Translation',
-  description: 'Any contract, filing or certificate, in any language a buyer names, translated with its layout, tables, stamps and footnotes kept where they were.',
+  description: 'Any document, translated with its layout kept.',
   input: { document: 'file', to: 'language: a BCP 47 tag, such as fr-CA' },
   output: { document: 'file' },
   price: 49,
npx services.dev check
✓ ready to sell · 1 Service · AI delivers it alone · it keeps at least 80% of every job

Explained in

What an agent reads

npx services.dev check --json · the description_too_long failure
{
  "code": "description_too_long",
  "reason": "The tool description is over 30 words, so agents skim past it.",
  "next": "Shorten description: the tool description is 36 words.",
  "doc_url": "https://services.dev/docs/reference/check/description_too_long"
}
The whole document check --json prints
npx services.dev check --json
{
  "ai": {
    "cents_per_call": 42,
    "simulated": true
  },
  "mcp": {
    "tools": 13,
    "tokens": 4506,
    "sandbox": 9,
    "budget": 8000
  },
  "services": [
    {
      "path": "services/translation.ts",
      "lines": 5,
      "steps": "draft · ai → review · ai · adversarial",
      "ok": false,
      "price": "$49 per job, within 48 hours, charged on delivery.",
      "who": "AI delivers every job.",
      "agent": {