Agent skill

Reading Visual References

by lukapiskorec in lukapiskorec/craftbot

A skill your agent uses when the reference material for an experiment is photographs, drawings, or floor plans rather than (or alongside) a dimensioned manual, and dimensions or topology must be…

Custom licenceAuto-check passed

Install Reading Visual References

skills CLI
$ npx skills add lukapiskorec/craftbot --skill reading-visual-references -a claude-code

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

GitHub CLI
$ gh skill install lukapiskorec/craftbot reading-visual-references --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/lukapiskorec/craftbot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/reading-visual-references .claude/skills/reading-visual-references && 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
reading-visual-references
GitHub stars
143
Token cost
~994 tokens
SKILL.md length
586 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
Custom licence

At a glance

A skill your agent uses when the reference material for an experiment is photographs, drawings, or floor plans rather than (or alongside) a dimensioned manual, and dimensions or topology must be…

  • Works in 3 steps: Topology and counts from the images (bay… → Absolute dimensions from the building… → Member sections from named standard…
  • The reference material for an experiment is photographs
  • SKILL.md covers Overview, Assign each image a role…, Getting dimensions out of an… and When there is no manual at all, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Reading Visual References is an agent skill from lukapiskorec/craftbot. Use when the reference material for an experiment is photographs, drawings, or floor plans rather than (or alongside) a dimensioned manual, and dimensions or topology must be read off images.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: CraftBot is an architect AI agent. It interprets design briefs, grounds its thinking in domain knowledge through ingesting documents, images and other references, and outputs…

When your agent uses it

  • The reference material for an experiment is photographs
  • Floor plans rather than (or alongside) a dimensioned manual
  • Topology must be read off images

Example prompts

  • “/reading-visual-references”

Workflow steps

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

  1. Topology and counts from the images (bay count, truss type, brace positions).
  2. Absolute dimensions from the building program (a two-car carport gives a 6 m span).
  3. Member sections from named standard practice, chosen as a consistent family, not one at a time ("standard Scandinavian/N-American…

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Reading Visual References loads about 994 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 586 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~994

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); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 586 words (~994 tokens).

“Images answer different questions than documents do, and different images answer different questions than each other. The recurring failure is asking an image for something it cannot say (a plan for pane counts, a photo for absolute dimensions) and building…”

— opening of SKILL.md by lukapiskorec, Custom licence
name
reading-visual-references

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/reading-visual-references of lukapiskorec/craftbot.

Open the folder on GitHubat commit 2c9715b

Compare with similar skills

Reading Visual References 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.

Reading Visual References compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reading Visual References this skilllukapiskorec/craftbot143—~994Automated safety check: PassCustom licence
ExperimentsArize-ai/phoenix12k—~1.8kAutomated safety check: PassCustom licence
Scroll Experiencesickn33/agentic-awesome-skills47k2 repos~534Automated safety check: PassMIT
Webgl Experiencenexu-io/open-design100k—~903Automated safety check: PassApache-2.0
Reading Levelthedaviddias/Front-End-Checklist74k—~613Automated safety check: PassMIT
Scroll Experiencedavila7/claude-code-templates32k2 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Experiments

    Arize-ai/phoenix

    Run, read, and compare dataset-backed experiments to find evidence that a prompt or pipeline is improving.

    12k GitHub stars~1.8k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Scroll Experience

    sickn33/agentic-awesome-skills

    Expert in building immersive scroll-driven experiences - parallax storytelling, scroll animations, interactive narratives, and cinematic web experiences.

    47k GitHub starsUsed in 2 repos~534 tokens
    Writing & ContentAuto-check passed
  • Webgl Experience

    nexu-io/open-design

    A full-screen, real-time WebGL/WebGL2 experience — animated shaders, 3D scenes, generative visuals, particle fields — rendered live on the GPU with a typographic overlay.

    100k GitHub stars~903 tokensUpdated today
    Game DevelopmentAuto-check passed
  • Reading Level

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing content pages for user experience and SEO.

    74k GitHub stars~613 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Scroll Experience

    davila7/claude-code-templates

    Expert in building immersive scroll-driven experiences - parallax storytelling, scroll animations, interactive narratives, and cinematic web experiences.

    32k GitHub starsUsed in 2 repos~1.5k tokens
    Frontend & DesignAuto-check passed
  • Read Session

    asgeirtj/system_prompts_leaks

    Locate and read Muse Code's OWN session logs — the current session or a prior one.

    69k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed

More from lukapiskorec/craftbot

All 13 skills in this repo
  • Turns a finished CraftBot building model into cut lists, stick orders and full-scale printable sheets for building a physical scale model by hand.

    143 GitHub stars~2.8k tokensUpdated 6 days ago
    Auto-check passed
  • Running a CraftBot Experiment

    lukapiskorec/craftbot

    Runs the six-agent CraftBot workflow in this specific repository, turning a design brief and references into versioned Blender Python scripts, renders, a rationale and an archived transcript.

    143 GitHub stars~9.1k tokensUpdated 6 days ago
    Auto-check passed
  • Rules for continuing or remodeling a prior CraftBot building script: treat the inherited model as a found object, audit it against the brief, and track every change.

    143 GitHub stars~750 tokensUpdated 6 days ago
    Auto-check passed
  • Modular Grids and Panelization

    lukapiskorec/craftbot

    Derives a building's dimensional grid from real sheet, panel, and transport constraints instead of hard-coding spacing numbers.

    143 GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed
  • Non-Orthogonal Timber Geometry

    lukapiskorec/craftbot

    Rules for modeling sloped, twisted and warped timber structures from straight members: ruled surfaces, per-bay framing, plane-cut legs and slab-exact clipping.

    143 GitHub stars~1.2k tokensUpdated 6 days ago
    Auto-check passed
  • Guides Blender Python that generates construction geometry from derived parametric expressions instead of hand-typed coordinates, so changes propagate and overlaps stay checkable.

    143 GitHub stars~1.4k tokensUpdated 6 days ago
    Auto-check passed

Questions about Reading Visual References

What does Reading Visual References do?

A skill your agent uses when the reference material for an experiment is photographs, drawings, or floor plans rather than (or alongside) a dimensioned manual, and dimensions or topology must be…. Reading Visual References is an agent skill from lukapiskorec/craftbot. Use when the reference material for an experiment is photographs, drawings, or floor plans rather than (or alongside) a dimensioned manual, and dimensions or topology must be read off images.

When should I use Reading Visual References?

Reading Visual References fits situations like: the reference material for an experiment is photographs; floor plans rather than (or alongside) a dimensioned manual; topology must be read off images.

How do I install Reading Visual References in Claude Code?

Run `npx skills add lukapiskorec/craftbot --skill reading-visual-references -a claude-code`. Or copy the skill folder (skills/reading-visual-references in lukapiskorec/craftbot) into .claude/skills/reading-visual-references in your project. Claude Code loads it when a task matches its description.

How do I install Reading Visual References in Codex?

Run `npx skills add lukapiskorec/craftbot --skill reading-visual-references -a codex`. Or copy the skill folder (skills/reading-visual-references in lukapiskorec/craftbot) into .agents/skills/reading-visual-references in your project. Codex loads it when a task matches its description.

Can I use Reading Visual References 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 lukapiskorec/craftbot --skill reading-visual-references -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reading-visual-references, .gemini/skills/reading-visual-references, .github/skills/reading-visual-references and .opencode/skills/reading-visual-references in your project.

What does Reading Visual References need to run?

SKILL.md names no scripts, command-line tools or credentials: Reading Visual References is instructions for the agent only.

Does Reading Visual References access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Reading Visual References 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. Review the folder before installing.

What licence does Reading Visual References use?

Reading Visual References has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Reading Visual References use?

About 994 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reading Visual References?

Skills that share tags, products or a category with Reading Visual References: Experiments (Arize-ai/phoenix, 12k stars), Scroll Experience (sickn33/agentic-awesome-skills, 47k stars), Webgl Experience (nexu-io/open-design, 100k stars) and Reading Level (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reading Visual References?

lukapiskorec (a GitHub user) maintains it in lukapiskorec/craftbot, which has 143 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 30, 2026.

Source: lukapiskorec/craftbot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.