Agent skill

Perforatedai Plot

by PerforatedAI in PerforatedAI/PerforatedAI

Render a single-panel PAI figure of score versus parameter count from sweep CSVs, PAI run folders, or hand-supplied numbers.

Apache-2.0Auto-check passedAI & LLM Engineering

Install Perforatedai Plot

skills CLI
$ npx skills add PerforatedAI/PerforatedAI --skill perforatedai-plot -a claude-code

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

GitHub CLI
$ gh skill install PerforatedAI/PerforatedAI perforatedai-plot --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/PerforatedAI/PerforatedAI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/perforatedai-plot .claude/skills/perforatedai-plot && 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
perforatedai-plot
GitHub stars
237
Token cost
~1.6k tokens
SKILL.md length
756 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

Render a single-panel PAI figure of score versus parameter count from sweep CSVs, PAI run folders, or hand-supplied numbers.

  • Works in 7 steps: Choose the source → Output name and location → Title → …
  • Tasks that involve CSV and tabular files
  • SKILL.md covers Overview, Scripts, Entry Point and Spec shape, plus 1 more section
  • Calls python3

What it does

Perforatedai Plot is an agent skill from PerforatedAI/PerforatedAI. Render a single-panel PAI figure of score versus parameter count from sweep CSVs, PAI run folders, or hand-supplied numbers. Trigger: 'make the PAI graph', 'plot params vs score', 'plot my dendrite results'. Builds a JSON spec, then renders it with dataprocessing/plotstreams.py. Figures only, no analysis. For recommendations use perforatedai-analyze.

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

It sits in AI & LLM Engineering, covering CSV and tabular files and Deep learning. The repository describes itself as: Add Dendrites to your PyTorch Project. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve CSV and tabular files
  • Tasks that involve Deep learning

Example prompts

  • “make the PAI graph”
  • “plot params vs score”
  • “plot my dendrite results”
  • “/perforatedai-plot”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Choose the source
  2. Output name and location
  3. Title
  4. Y axis
  5. Streams
  6. Anchor and colors
  7. Render and check

What it can do on your machine

Read from SKILL.md and the folder at commit 9d317e6. 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

    Shell commands in SKILL.md call:

    • python3

    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

Perforatedai Plot loads about 1.6k tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 756 words of instructions outside code blocks.

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

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

The full file from PerforatedAI/PerforatedAI at commit 9d317e6, republished under its Apache-2.0 licence (© PerforatedAI). 756 words, ~1,611 tokens.

Download SKILL.mdSave it as .claude/skills/perforatedai-plot/SKILL.md (or your agent's skills folder).
name
perforatedai-plot
description
Render a single-panel PAI figure of score versus parameter count from sweep CSVs, PAI run folders, or hand-supplied numbers. Trigger: 'make the PAI graph', 'plot params vs score', 'plot my dendrite results'. Builds a JSON spec, then renders it with data_processing/plot_streams.py. Figures only, no analysis. For recommendations use perforatedai-analyze.

PerforatedAI Plot Skill

Overview

This skill produces one publication-style figure: parameter count on the x axis, a score on the y axis, one line or scatter stream per model or configuration. It reads a JSON spec of literal numbers and renders it with data_processing/plot_streams.py. The spec is the frozen record of the figure, so every number in the PNG can be traced back.

When to use this skill:

  • After a sweep, to draw the best score per dendrite count per model
  • After one or more PAI training runs, to draw score against parameters
  • When the user hands you numbers and wants them in the shared PAI style

Not for: interpreting results or recommending settings. That is the perforatedai-analyze skill.

Scripts

All scripts live in data_processing/ of the PerforatedAI repository. Run them from that directory or by absolute path.

ScriptPurpose
plot_streams.pyRender a spec to a PNG
spec_from_csv.pyBuild a spec from a sweep CSV or from PAI run folders
pai_style.pyShared colors and axes style, imported by the others
example_spec.jsonA working spec showing every optional field

Plotting is read-only work and runs on the local machine.

Entry Point

Ask the user one question at a time. Offer a recommended default with each question and wait for the answer before the next one.

Step 0: Choose the source

Ask which of the three sources the figure comes from:

  1. Sweep CSV: a by-dendrite-separate CSV from get_wandb_results.py --mode by-dendrite-separate. One stream per model, one point per dendrite count.
  2. PAI run folders: folders holding <save_name>_best_arch_scores.csv from UPA.perforate_model(save_name=...). Each stream is a list of folders, one point per folder by default.
  3. Numbers: values the user supplies, or that you pull from W&B in session and write into the spec as literals.
Step 1: Output name and location

Ask for the PNG stem, for example yolo26_cityscapes. Then ask where the PNG and spec copy should go. Recommend the directory that will hold the spec. Pass the answer to plot_streams.py as an absolute --out-dir.

Step 2: Title

Optional. Always ask.

Step 3: Y axis

Ask for the label. It is required. Ask for the value format only when the metric is not a four decimal quantity, the default is .4f. The x axis defaults to "Parameters (millions)" with raw counts in the spec divided by 1e6 at plot time. Ask for a custom x label only if the user mentions a different x quantity.

Show full SKILL.md (354 more words)Show less
Step 4: Streams

Sweep CSV. Ask which stat collapses the runs in each column, recommend max. Then build:

bash
python3 data_processing/spec_from_csv.py \
    --csv path/to/sweep_by_dendrite_separate.csv \
    --out NAME --spec-path DIR/NAME.json \
    --title "..." --y-label "..." --stat max

Stream names come from model_info.csv beside the CSV when it exists, otherwise model_0, model_1. Ask the user whether to rename them.

Run folders. Ask which folders go in each stream and what each stream is called. Ask whether a stream takes the best point per folder or every dendrite count from a single folder (--all-dendrites). Then build:

bash
python3 data_processing/spec_from_csv.py \
    --stream Vanilla:runs/nano_plain,runs/small_plain \
    --stream PAI:runs/nano_pai,runs/small_pai \
    --out NAME --spec-path DIR/NAME.json --title "..." --y-label "..."

--metric names the column of best_arch_scores.csv, default Max Valid Scores. --best min selects the lowest row for losses.

Numbers. Write the spec by hand following example_spec.json. When pulling from W&B, default to the best epoch by the run's primary metric, confirm that rule with the user, and take parameter counts from <save_name>_best_arch_scores.csv or <save_name>param_counts.csv, not from W&B's fused parameter field. Record run ids, files, and the pull date in each stream's source field.

Step 5: Anchor and colors

Ask whether there is a vanilla or zero dendrite point that belongs to no stream. If so it becomes the spec's anchor, drawn hollow, and line streams start from it. Streams take colors in order from pai_style.stream_palette: teal, gray, dark blue, orange, then evenly spaced hues. Ask only if the user wants a stream pinned to a color, set with the stream's color field.

Step 6: Render and check
bash
python3 data_processing/plot_streams.py DIR/NAME.json --out-dir DIR

Open the PNG with Read and show the user. Ask whether any labels collide. If so, add per point offset values [dx, dy, ha, va] in points and re-render. The builder turns annotations off when a stream has more than eight points, flip annotate back on if the user wants them.

Spec shape

json
{
  "out": "yolo26_cityscapes",
  "title": "Cityscapes Perforated YOLO26",
  "x_axis": {"label": "Steps"},
  "y_axis": {"label": "mAP50-95", "format": ".4f", "lim": [0.25, 0.28]},
  "annotate": true,
  "anchor": {"x": 2506920, "y": 0.26187, "name": "Vanilla",
             "source": "..."},
  "streams": [
    {"name": "PAI", "style": "line", "from_anchor": true,
     "color": "#00FAC9",
     "points": [[2571528, 0.26447],
                {"x": 2636136, "y": 0.27322, "label": "2d",
                 "offset": [10, -8, "left", "top"]}],
     "source": "run id, file, date"},
    {"name": "L2_Full", "style": "scatter", "dash_to_anchor": true,
     "points": [[2585520, 0.26641]]}
  ]
}

Omit x_axis for the default parameters axis. title, lim, format, annotate, anchor, color, from_anchor, dash_to_anchor, label and offset are optional. A point is [x, y] or an object with x, y, and optional label and offset.

Style

Every figure the repository produces shares data_processing/pai_style.py: dotted grid on both axes, no top or right spine, framed legend, 200 dpi with a tight bounding box. Do not set colors, grids, or dpi inline in a new plotting script, import pai_style instead.

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

Files

Just SKILL.md in skills/perforatedai-plot of PerforatedAI/PerforatedAI.

Open the folder on GitHubat commit 9d317e6

Compare with similar skills

Perforatedai Plot 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.

Perforatedai Plot compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Perforatedai Plot this skillPerforatedAI/PerforatedAI237—~1.6kAutomated safety check: PassApache-2.0
Anomalib Benchmarkingopen-edge-platform/anomalib6.2k—~1kAutomated safety check: PassApache-2.0
Yolo Trainingfcakyon/claude-codex-settings1.2k1 repos~1.4kAutomated safety check: PassApache-2.0
Codemie Analyticscodemie-ai/codemie-code294—~7.5kAutomated safety check: PassApache-2.0
Render HTMLwanshuiyin/ARIS-in-AI-Offer574—~4.9kAutomated safety check: NotesMIT
Skill Sync CheckerPINA-org/PINA797—~1.5kAutomated safety check: PassMIT

Similar skills

  • Anomalib Benchmarking

    open-edge-platform/anomalib

    Runs the anomalib benchmarking pipeline to train/evaluate a grid of model + dataset (+ category) combinations and collect metrics into a results CSV.

    6.2k GitHub stars~1k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Yolo Training

    fcakyon/claude-codex-settings

    This skill should be used when user asks to "improve my mAP", "why is my model overfitting", "my training is diverging", "read my results.csv", "interpret my training curves", "my AP50 is good but…

    1.2k GitHub starsUsed in 1 repo~1.4k tokens
    AI & LLM EngineeringAuto-check passed
  • Codemie Analytics

    codemie-ai/codemie-code

    CodeMie Analytics expert — use this skill whenever the user asks about CodeMie usage data, AI adoption metrics, user leaderboards, CLI insights, spending, LiteLLM costs, token usage, or wants to…

    294 GitHub stars~7.5k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Render HTML

    wanshuiyin/ARIS-in-AI-Offer

    Render an ARIS Markdown / JSON artifact (IDEAREPORT, AUTOREVIEW, KILLARGUMENT, PAPERPLAN, research-wiki state, etc.) into a single-file HTML view designed for human reading.

    574 GitHub stars~4.9k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check: notes
  • Skill Sync Checker

    PINA-org/PINA

    Audits SKILL.md files in this repo's skills directory for references to functions, classes, or modules (mentioned by name in prose, e.g.

    797 GitHub stars~1.5k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Extracting Clinical Entities

    maziyarpanahi/openmed

    Run clinical and biomedical named-entity recognition on medical text with OpenMed's analyzetext.

    5.5k GitHub stars~1.9k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

More from PerforatedAI/PerforatedAI

  • Perforatedai Complex Methods

    PerforatedAI/PerforatedAI

    Solutions for non-trivial PerforatedAI integration scenarios.

    237 GitHub stars~821 tokensUpdated yesterday
    Auto-check passed
  • Perforatedai Libraries Transformers

    PerforatedAI/PerforatedAI

    HuggingFace Transformers integration for PerforatedAI. An agent skill from PerforatedAI/PerforatedAI.

    237 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Perforatedai

    PerforatedAI/PerforatedAI

    Expert in PerforatedAI library for adding artificial dendrites to PyTorch neural networks.

    237 GitHub stars~17k tokensUpdated yesterday
    Auto-check passed
  • Perforatedai Analyze

    PerforatedAI/PerforatedAI

    Analyze PerforatedAI training results and provide optimization recommendations.

    237 GitHub stars~5.1k tokensUpdated yesterday
    Auto-check passed
  • Perforatedai Wandb

    PerforatedAI/PerforatedAI

    WandB-specific PerforatedAI integration guardrail skill. An agent skill from PerforatedAI/PerforatedAI.

    237 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed
  • Perforatedai Distributed

    PerforatedAI/PerforatedAI

    Multi-GPU setup for PerforatedAI with DataParallel or DistributedDataParallel (DDP).

    237 GitHub stars~5.5k tokensUpdated yesterday
    Auto-check passed

Questions about Perforatedai Plot

What does Perforatedai Plot do?

Render a single-panel PAI figure of score versus parameter count from sweep CSVs, PAI run folders, or hand-supplied numbers. Perforatedai Plot is an agent skill from PerforatedAI/PerforatedAI. Render a single-panel PAI figure of score versus parameter count from sweep CSVs, PAI run folders, or hand-supplied numbers.

When should I use Perforatedai Plot?

Perforatedai Plot fits situations like: tasks that involve CSV and tabular files; tasks that involve Deep learning.

How do I install Perforatedai Plot in Claude Code?

Run `npx skills add PerforatedAI/PerforatedAI --skill perforatedai-plot -a claude-code`. Or copy the skill folder (skills/perforatedai-plot in PerforatedAI/PerforatedAI) into .claude/skills/perforatedai-plot in your project. Claude Code loads it when a task matches its description.

How do I install Perforatedai Plot in Codex?

Run `npx skills add PerforatedAI/PerforatedAI --skill perforatedai-plot -a codex`. Or copy the skill folder (skills/perforatedai-plot in PerforatedAI/PerforatedAI) into .agents/skills/perforatedai-plot in your project. Codex loads it when a task matches its description.

Can I use Perforatedai Plot 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 PerforatedAI/PerforatedAI --skill perforatedai-plot -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/perforatedai-plot, .gemini/skills/perforatedai-plot, .github/skills/perforatedai-plot and .opencode/skills/perforatedai-plot in your project.

What does Perforatedai Plot need to run?

Going by SKILL.md and its folder, Perforatedai Plot needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Perforatedai Plot 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 Perforatedai Plot 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 Perforatedai Plot use?

Perforatedai Plot is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Perforatedai Plot use?

About 1.6k tokens (SKILL.md is roughly 6.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 Perforatedai Plot?

Skills that share tags, products or a category with Perforatedai Plot: Anomalib Benchmarking (open-edge-platform/anomalib, 6.2k stars), Yolo Training (fcakyon/claude-codex-settings, 1.2k stars), Codemie Analytics (codemie-ai/codemie-code, 294 stars) and Render HTML (wanshuiyin/ARIS-in-AI-Offer, 574 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Perforatedai Plot?

PerforatedAI (a GitHub organization) maintains it in PerforatedAI/PerforatedAI, which has 237 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

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