Agent skill

Ppi Network Analysis

by aipoch in aipoch/medical-research-skills

A skill your agent uses when you need a standardized R CLI workflow to build a protein-protein interaction network from a local gene list and an offline STRING cache, export node and edge tables…

MITAuto-check passedDocuments & Office

Install Ppi Network Analysis

skills CLI
$ npx skills add aipoch/medical-research-skills --skill ppi-network-analysis -a claude-code

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

GitHub CLI
$ gh skill install aipoch/medical-research-skills ppi-network-analysis --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/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'awesome-med-research-skills/Data Analysis/ppi-network-analysis' .claude/skills/ppi-network-analysis && 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
ppi-network-analysis
GitHub stars
2k
Token cost
~2.2k tokens
SKILL.md length
883 words
Files
29 (incl. scripts, references)
Skills in repo
567
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when you need a standardized R CLI workflow to build a protein-protein interaction network from a local gene list and an offline STRING cache, export node and edge tables…

  • You need a standardized R CLI workflow to build a protein-protein interaction network from a local gene list and an offline STRING cache
  • SKILL.md covers When to Read External Files, Usage, Arguments and Input Format, plus 3 more sections
  • Runs R scripts from its folder
  • Export node and edge tables

What it does

Ppi Network Analysis is an agent skill from aipoch/medical-research-skills. Use when you need a standardized R CLI workflow to build a protein-protein interaction network from a local gene list and an offline STRING cache, export node and edge tables, and render a reproducible PDF network plot. NOT for online API fetching, arbitrary graph databases, multi-omics integration, or non-STRING interaction sources.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 31 other files, including scripts and reference files (for example `eval_report_ppi-network-analysis_result.json`, `references/algorithm.md` and `references/cli-guide.md`).

It sits in Documents & Office. The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

When your agent uses it

  • You need a standardized R CLI workflow to build a protein-protein interaction network from a local gene list and an offline STRING cache
  • Export node and edge tables
  • Render a reproducible PDF network plot

Example prompts

  • “/ppi-network-analysis”

What it can do on your machine

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

    Ships 7 files in scripts/ (R, from the files we listed), which the agent can run.

    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

Ppi Network Analysis loads about 2.2k tokens when it runs, and up to ~49.1M if it reads all its reference files. Until then it costs about 89 tokens; SKILL.md has 883 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~49.1M

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); the scripts in this folder are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 883 words, ~2,244 tokens.

Download SKILL.mdSave it as .claude/skills/ppi-network-analysis/SKILL.md (or your agent's skills folder). This skill also uses 28 other files; get the full folder from GitHub.
name
ppi-network-analysis
description
Use when you need a standardized R CLI workflow to build a protein-protein interaction network from a local gene list and an offline STRING cache, export node and edge tables, and render a reproducible PDF network plot. NOT for online API fetching, arbitrary graph databases, multi-omics integration, or non-STRING interaction sources.
license
MIT
author
AIPOCH

Source: https://github.com/aipoch/medical-research-skills

PPI Network Analysis

When to Read External Files

SituationFile to ReadPurpose
Need algorithm detailsreferences/algorithm.mdExplain local STRING mapping, interaction filtering, network metrics, and plot interpretation
Need to execute the analysisscripts/main.RRun the CLI entry point with a complete Rscript command
Encounter an errorreferences/troubleshooting.mdMap standardized error codes to causes and fixes
Need CLI examples or baseline usagereferences/cli-guide.mdReview installation notes, offline cache requirements, and runnable examples
Need a runnable smoke testtests/data/Use the bundled small gene list for verification

Usage

bash
Rscript scripts/main.R \
  --genelist_file ./input/gene_list.csv \
  --species human \
  --threshold 700 \
  --output_dir output/basic-run \
  --seed 42 \
  --timeout_seconds 600
bash
Rscript scripts/main.R \
  --plot_only TRUE \
  --output_dir output/basic-run \
  --seed 42 \
  --timeout_seconds 600

Arguments

ShortLongTypeDefaultRequiredDescription
-g--genelist_filecharacternoneyes, unless --plot_only TRUEGene list file in CSV, TSV, TXT, or XLSX format
-s--speciescharacternoneyes, unless --plot_only TRUESpecies: human, mouse, 9606, or 10090
-t--thresholdintegernoneyes, unless --plot_only TRUESTRING combined-score threshold from 400 to 1000
-o--output_dircharacteroutputnoOutput directory inside the skill root
-p--plot_onlylogicalFALSEnoReuse output_dir/data/ppi_result.rds and regenerate the network plot
-d--seedinteger42noRandom seed used for layout reproducibility
-u--timeout_secondsinteger600noElapsed time limit in seconds
--string_cache_dircharacterreferences/string_cachenoLocal STRING cache directory; if omitted, the bundled cache inside the skill is used
--string_versioncharacterautonoPreferred STRING cache version; use auto, v11.5, or v12.0 when available
--figure_familycharactersansnoPDF font family: sans, serif, or mono
--figure_widthnumeric12noPlot width in inches
--figure_heightnumeric10noPlot height in inches
--labelcharacternodenoLabel mode: node or none
--label_sizenumeric0.8noLabel size
--label_colorcharacterblacknoLabel color
--label_distnumeric0noLabel distance from the node center
--line_alphanumeric1noEdge alpha
--line_colorcharacterbuilt-in palettenoComma-separated edge colors
--line_sizenumeric0.8noBase edge width
--line_typecharactersolidnoEdge line type; supported values in plotting are solid, dashed, or dotted
--mapping_link_alphacharactervaluenoMap edge alpha from interaction score: value or none
--mapping_link_colorcharactervaluenoMap edge color from interaction score: value or none
--mapping_link_sizecharactervaluenoMap edge width from interaction score: value or none
--mapping_node_alphacharacternonenoMap node alpha from degree: value or none
--mapping_node_colorcharacternonenoMap node color from degree: value or none
--mapping_node_sizecharactervaluenoMap node size from degree: value or none
--point_alphanumeric1noNode alpha
--point_colorcharacterbuilt-in palettenoComma-separated node border colors
--point_fillcharacterbuilt-in palettenoComma-separated node fill colors
--point_shapecharactercirclenoNode shape: circle or square
--point_sizenumeric12noBase node size
--style_layoutcharacternicelynoLayout style: kk, fr, nicely, circle, star, grid, or randomly
--style_linecharacterstraightnoEdge style: straight or curve
--theme_sizenumeric0.8noTheme size placeholder retained for compatibility
--titlecharacteremptynoMain plot title

Input Format

Supported input types

--genelist_file accepts the following formats:

  • .csv
  • .tsv
  • .txt
  • .xlsx
Show full SKILL.md (399 more words)Show less
Gene list parsing rules
  • Plain-text .txt files can be provided as one gene symbol per line without a header.
  • For .csv, .tsv, and .xlsx, the tool automatically selects a likely gene column.
  • Preferred column names include: gene, genes, genename, genesymbol, symbol, hgnc, hgncsymbol, mgi, ensembl, ensemblgeneid, geneid, and id.
  • If no standard gene column name is found, the tool falls back to the column with the strongest non-numeric signal.
  • Values may contain multiple genes separated by commas, semicolons, pipes, tabs, or spaces; these are split automatically.
  • Empty inputs, unsupported file extensions, or inputs with no parsable genes will raise a SKILL_EMPTY_DATA or SKILL_INVALID_PARAMETER error.
Minimal examples
TXT example
text
TP53
EGFR
BRCA1
MYC
CSV example
csv
gene
TP53
EGFR
BRCA1
MYC

Output Files

FileFormatDescription
data/ppi_result.rdsRDSSerialized PPI bundle with mappings, interactions, nodes, summary, and metadata
table/ppi_network_edges.xlsxXLSXEdge table with from, to, and combined_score
table/ppi_network_nodes.xlsxXLSXNode table with gene, degree, betweenness, and closeness
table/ppi_summary.csvCSVSummary metrics for input genes, mapped genes, unmapped genes, nodes, edges, and threshold
plot/ppi_network_plot.pdfPDFRendered PPI network plot from the local STRING interaction graph
session_info.txtTXTR version, platform, and package version information

Error Handling

Error CodeMeaningHow to Fix
SKILL_FILE_NOT_FOUNDInput gene list, STRING cache directory, required cache files, or data/ppi_result.rds in plot-only mode was not foundConfirm the path exists, required cache files are present, and run a full analysis before --plot_only TRUE
SKILL_EMPTY_DATANo valid genes were parsed, no genes mapped to STRING, fewer than two mapped STRING IDs remained, no interactions passed filtering, or the interaction table was empty for plottingCheck that the input is not empty, verify gene symbols are supported by the local STRING cache, and lower the threshold if the network is too sparse
SKILL_INVALID_PARAMETERA required argument is missing, a numeric value is out of range, an unsupported choice was supplied, the output path is invalid, or the input extension is unsupportedRecheck the parameter value and allowed choices, especially --species, --threshold, mapping options, plot options, and output paths
SKILL_MISSING_COLUMNSRequired columns were not found in a STRING cache tableConfirm the local aliases, info, and links files are valid STRING cache files with expected columns
SKILL_PACKAGE_NOT_FOUNDRequired R packages are not installedInstall the missing packages listed in the error message before rerunning

Detailed fixes and troubleshooting steps: READ references/troubleshooting.md

Testing

Smoke test with bundled data
bash
Rscript scripts/main.R \
  --genelist_file tests/data/gene_list.csv \
  --species human \
  --threshold 700 \
  --output_dir tests/output/basic-run
Plot-only regeneration test
bash
Rscript scripts/main.R \
  --plot_only TRUE \
  --output_dir tests/output/basic-run \
  --seed 42
Expected outputs after test
  • tests/output/basic-run/data/ppi_result.rds
  • tests/output/basic-run/table/ppi_network_edges.xlsx
  • tests/output/basic-run/table/ppi_network_nodes.xlsx
  • tests/output/basic-run/table/ppi_summary.csv
  • tests/output/basic-run/plot/ppi_network_plot.pdf
  • tests/output/basic-run/session_info.txt

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

Files

SKILL.md and 28 other files (scripts, references) in awesome-med-research-skills/Data Analysis/ppi-network-analysis of aipoch/medical-research-skills.

  • SKILL.md
  • eval_report_ppi-network-analysis_result.json
  • references/algorithm.md
  • references/cli-guide.md
  • references/string_cache/10090.protein.aliases.v11.5.txt.gz
  • references/string_cache/10090.protein.info.v11.5.txt.gz
  • references/string_cache/10090.protein.links.v11.5.txt.gz
  • references/string_cache/9606.protein.aliases.v11.5.txt.gz
  • references/string_cache/9606.protein.info.v11.5.txt.gz
  • references/string_cache/9606.protein.links.v11.5.txt.gz
  • references/troubleshooting.md
  • scripts/cli_options.R
  • scripts/core_option_groups.R
  • scripts/functions.R
  • scripts/io.R
  • scripts/main.R
  • scripts/option_validation.R
  • scripts/path_utils.R
  • … and 11 more

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Ppi Network Analysis 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.

Ppi Network Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ppi Network Analysis this skillaipoch/medical-research-skills2k—~2.2kAutomated safety check: PassMIT
Pathmldavila7/claude-code-templates32k12 repos~1.9kAutomated safety check: PassMIT
Research Writingalfonso0512/research-writing-skill4871 repos~818Automated safety check: PassMIT
Paper WritingMLNLP-World/Paper-Writing-Tips4.7k—~630Automated safety check: PassNone
PaperjurySpark-To-Paper-Skills/paperjury1.2k—~5.3kAutomated safety check: PassMIT
Literature Surveyai4s-research/ai4s-skills2372 repos~2kAutomated safety check: PassMIT

Similar skills

  • Pathml

    davila7/claude-code-templates

    Computational pathology toolkit for analyzing whole-slide images (WSI) and multiparametric imaging data.

    32k GitHub starsUsed in 12 repos~1.9k tokens
    Documents & OfficeAuto-check passed
  • Research Writing

    alfonso0512/research-writing-skill

    科研论文写作助手,提供 30 个 Prompt 模板覆盖论文写作全流程. An agent skill from alfonso0512/research-writing-skill.

    487 GitHub starsUsed in 1 repo~818 tokens
    Documents & OfficeAuto-check passed
  • Paper Writing

    MLNLP-World/Paper-Writing-Tips

    学术论文写作检查与优化助手。基于 MLNLP-World 社区整理的论文写作技巧,帮助检查和优化学术论文。Use when: (1) 检查论文 LaTeX 格式和排版, (2) 优化公式符号使用, (3) 改进图表设计, (4) 润色英文学术表达, (5) 检查参考文献格式, (6) 投稿前终稿检查, (7) 用户询问论文写作技巧或规范。

    4.7k GitHub stars~630 tokensUpdated 12 days ago
    Documents & OfficeAuto-check passed
  • Paperjury

    Spark-To-Paper-Skills/paperjury

    Three modes for CS-conference papers (CVPR/ICCV/ECCV vision, ACL/EMNLP/NAACL NLP, ICLR/NeurIPS/ICML/AAAI ML).

    1.2k GitHub stars~5.3k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Literature Survey

    ai4s-research/ai4s-skills

    A skill your agent uses when the user wants a comprehensive literature survey on a specific research topic.

    237 GitHub starsUsed in 2 repos~2k tokens
    Documents & OfficeAuto-check passed
  • Venue Templates

    K-Dense-AI/claude-scientific-writer

    Prepare journal manuscripts, conference papers, research posters, and grant documents using venue-specific formatting guidance and bundled LaTeX scaffolds.

    2.4k GitHub starsUsed in 2 repos~2.9k tokens
    Documents & OfficeAuto-check passed

More from aipoch/medical-research-skills

All 567 skills in this repo
  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    2k GitHub stars~2.2k tokensUpdated 21 days ago
    Auto-check passed
  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    2k GitHub stars~1.4k tokensUpdated 21 days ago
    Auto-check passed
  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    2k GitHub stars~3.7k tokensUpdated 21 days ago
    Auto-check passed
  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    2k GitHub stars~1.8k tokensUpdated 21 days ago
    Auto-check passed
  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    2k GitHub stars~1.7k tokensUpdated 21 days ago
    Auto-check passed
  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    2k GitHub stars~1.3k tokensUpdated 21 days ago
    Auto-check passed

Questions about Ppi Network Analysis

What does Ppi Network Analysis do?

A skill your agent uses when you need a standardized R CLI workflow to build a protein-protein interaction network from a local gene list and an offline STRING cache, export node and edge tables…. Ppi Network Analysis is an agent skill from aipoch/medical-research-skills. Use when you need a standardized R CLI workflow to build a protein-protein interaction network from a local gene list and an offline STRING cache, export node and edge tables, and render a reproducible PDF network plot.

When should I use Ppi Network Analysis?

Ppi Network Analysis fits situations like: you need a standardized R CLI workflow to build a protein-protein interaction network from a local gene list and an offline STRING cache; export node and edge tables; render a reproducible PDF network plot.

How do I install Ppi Network Analysis in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill ppi-network-analysis -a claude-code`. Or copy the skill folder (awesome-med-research-skills/Data Analysis/ppi-network-analysis in aipoch/medical-research-skills) into .claude/skills/ppi-network-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Ppi Network Analysis in Codex?

Run `npx skills add aipoch/medical-research-skills --skill ppi-network-analysis -a codex`. Or copy the skill folder (awesome-med-research-skills/Data Analysis/ppi-network-analysis in aipoch/medical-research-skills) into .agents/skills/ppi-network-analysis in your project. Codex loads it when a task matches its description.

Can I use Ppi Network Analysis 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 aipoch/medical-research-skills --skill ppi-network-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ppi-network-analysis, .gemini/skills/ppi-network-analysis, .github/skills/ppi-network-analysis and .opencode/skills/ppi-network-analysis in your project.

What does Ppi Network Analysis need to run?

Going by SKILL.md and its folder, Ppi Network Analysis needs R for the scripts in its folder.

Does Ppi Network Analysis 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 Ppi Network Analysis 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ppi Network Analysis use?

Ppi Network Analysis is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ppi Network Analysis use?

About 2.2k tokens (SKILL.md is roughly 9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 49.1M tokens, read only when the agent opens those files.

What are the alternatives to Ppi Network Analysis?

Skills that share tags, products or a category with Ppi Network Analysis: Pathml (davila7/claude-code-templates, 32k stars), Research Writing (alfonso0512/research-writing-skill, 487 stars), Paper Writing (MLNLP-World/Paper-Writing-Tips, 4.7k stars) and Paperjury (Spark-To-Paper-Skills/paperjury, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ppi Network Analysis?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,974 GitHub stars. The repository holds 567 skills in this directory. The repository was last updated on September 17, 2026.

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