Tools
Everything SCAPS-1D exposes to your AI client: tools, resources and prompts.
Tool docs quality: D — 16 tools graded
Average 49/100 for how clearly each description tells an AI client what the tool does, what it needs, and what it changes. It is not a security audit.
- Grade A: 0
- Grade B: 0
- Grade C: 6
- Grade D: 10
- Grade F: 0
scaps_batchtoolGrid or paired sweeps over set and action keys
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
New device from a layer, defect, interface and contact description
Description quality grade D, 40/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
Layers, defects, interfaces with band offsets, contacts, realism checks
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
Set commands, materials and solver numerics, saved as a new definition
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
Add a shared SCAPS file and report missing referenced files
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
scaps_jobstoolList, inspect, wait for or cancel runs
Description quality grade C, 60/100 · 3 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
scaps_list_filestoolDefinitions, materials, spectra, absorption, grading, measurement and other files
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
scaps_optimizetoolFit measured curves or optimise a figure of merit
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
scaps_plottoolPNG plot of result curves and profiles
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
scaps_resultstoolPaginated tables from any result file
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
scaps_run_scripttoolValidated SCAPS script for recorder, math, loops and tandem workflows
Description quality grade D, 40/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
Search the installed SCAPS command list
Description quality grade C, 60/100 · 3 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
scaps_simulatetoolOne simulation with metrics, curves, profiles, analysis and checks
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
scaps_sq_limittoolDetailed-balance limits for given band gaps and spectrum
Description quality grade C, 65/100 · 3 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
The description mentions what the tool takes.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
scaps_statustoolInstallation, version, run folder, plotting support, running jobs
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
scaps_write_datatoolWrite absorption, spectrum, generation, filter, grading or measurement files from data
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.