FD product-doc-reader
产品工程图纸结构化提取器 v5.0。pdftotext 优先 + Vision 兜底,支持软连字符清理/跨行关联/数据校验。专为 Farreach 线材产品图纸设计。
As a process D 49/100 · Unfinished process — weak spots: result and completion, when it triggers, inputs and preconditions
What is at stake
The skill contains fragments that, in the wrong hands, cost money or data. Below: what the installer risks and what the author should do.
The files contain someone else's key or token. If it is live, your agent will call third-party services under a stranger's identity; if it was revoked, the skill's scripts simply fail. Such a key often arrives with the author's whole workspace, personal data included.
The key is visible to everyone who downloaded the skill and has likely been copied by catalog-scanning bots already. Revoke it now, check bills and access logs, then reissue.
How to improve
- Remove the critical guard findings (secrets, dangerous commands, hidden instructions): while they stand the skill is blocked and cannot grade above F.
- Say in the description WHEN to use the skill ("use when…", example requests): that is the agent's main cue.
- Your own cases (evals/evals.json, 4–6 real requests with expected answers): the full check would then run those instead of a model-drafted suite.
- A spec.yaml with trigger phrases and assertions — a behaviour contract for CI; `skilltest init` writes a template.
Guard findings · 16
-
critical Secrets in code
secret-openrouter-keyscripts/extract_hybrid.py:365OpenRouter API key (quoted — discussed, not commanded)api_key = "sk-o…e6d"
quoted -
critical Secrets in code
secret-openrouter-keyscripts/extract_vision.py:207OpenRouter API key (quoted — discussed, not commanded)api_key = "sk-o…e6d"
quoted
Medium and low: 14
-
medium Secrets in code
secret-labelled-tokenscripts/extract_hybrid.py:365Labelled token / key literal (vendor format unknown — verify it is not a live credential)api_key = "sk-o…e6d"
-
medium Secrets in code
secret-labelled-tokenscripts/extract_vision.py:207Labelled token / key literal (vendor format unknown — verify it is not a live credential)api_key = "sk-o…e6d"
-
low Secrets in code
secret-high-entropy-tokenscripts/batch_599_full.py:19High-entropy token-like string (may be an id, hash or a credential) (quoted — discussed, not commanded)"599-001": "1Y_G…c3A",
quoted -
low Secrets in code
secret-high-entropy-tokenscripts/batch_599_full.py:20High-entropy token-like string (may be an id, hash or a credential) (quoted — discussed, not commanded)"599-002": "1122…YyO",
quoted -
low Secrets in code
secret-high-entropy-tokenscripts/batch_599_full.py:21High-entropy token-like string (may be an id, hash or a credential) (quoted — discussed, not commanded)"599-003": "1mHf…P_0",
quoted -
low Secrets in code
secret-high-entropy-tokenscripts/batch_599_full.py:22High-entropy token-like string (may be an id, hash or a credential) (quoted — discussed, not commanded)"599-004": "1Chu…k4e",
quoted -
low Secrets in code
secret-high-entropy-tokenscripts/batch_599_full.py:23High-entropy token-like string (may be an id, hash or a credential) (quoted — discussed, not commanded)"599-005": "1evz…wtc",
quoted -
low Secrets in code
secret-high-entropy-tokenscripts/batch_599.py:19High-entropy token-like string (may be an id, hash or a credential) (quoted — discussed, not commanded)"599-009": "19_z…cRn",
quoted -
low Secrets in code
secret-high-entropy-tokenscripts/batch_599.py:20High-entropy token-like string (may be an id, hash or a credential) (quoted — discussed, not commanded)"599-011": "1ibb…Q6S",
quoted -
low Secrets in code
secret-high-entropy-tokenscripts/batch_599.py:21High-entropy token-like string (may be an id, hash or a credential) (quoted — discussed, not commanded)"599-037": "1hFs…c5p",
quoted -
low Secrets in code
secret-high-entropy-tokenscripts/batch_599.py:22High-entropy token-like string (may be an id, hash or a credential) (quoted — discussed, not commanded)"599-038": "12PT…n9V",
quoted -
low Secrets in code
secret-high-entropy-tokenscripts/batch_599.py:23High-entropy token-like string (may be an id, hash or a credential) (quoted — discussed, not commanded)"599-045": "1ZYJ…bkZ",
quoted -
low Secrets in code
secret-password-literalscripts/extract_hybrid.py:365Hard-coded password / key literal (may be an example)api_key = "sk-o…e6d"
-
low Secrets in code
secret-password-literalscripts/extract_vision.py:207Hard-coded password / key literal (may be an example)api_key = "sk-o…e6d"
Files scanned: 28. Evidence is masked. Grey chips explain why severity was lowered.
Against the Agent Skills spec
- warning
description-no-whendescription does not say WHEN to use the skill (no "use when")
Process rating: all ten parameters 49/100
- 0Result and completion. Does not say what the result is
- 0Inputs and preconditions. Does not say what the process needs to start
- 0Failures and branches. Linear process with no failure handling
- 0Progress reporting. Says nothing while it works
- 20When it triggers. No condition that starts the skill
- 40Consistency. Frontmatter name (product-doc-reader) differs from the folder (ssa-product-doc-reader)
- 100Tools and files. No external tools needed
- 100Steps. 10 steps
- 100Execution cost. Instruction body is 1458 tokens
- 100Running it twice. No mutating operations
- low 10 top-level sections: this looks like several domains in one skill
Everything here is measured from the skill text rather than judged by a model, so the numbers are checkable. A parameter weighs more when it is a more common reason for the process to stall.
Quality signals
- +5Description has no quoted example phrases that should trigger the skill
- +4Description does not say when NOT to use the skill (false activations)
- +3Description length 83: 120–800 characters recommended
- +3Output format is not stated: the model decides each time
- -4Absolute local paths (C:\Users, /home/…): not portable
- -225 emoji in the instructions: noise for the model
- -33 of 6 scripts are never mentioned in SKILL.md
- +1No license
- +2Single-language instructions
- +4Structure: 25 headings
- +3Step-by-step instructions: 10 items
- +4Has examples (8 code blocks)
Quality base 70; lint remarks subtract, signals add up to 100. Result: 60.