Agent skill

Contribute Skills Via PR

by NeuroAIHub in NeuroAIHub/BrainPilot

Step-by-step guidance for contributing a new skill to the NeuroAIHub/awesomecognitiveandneuroscienceskills repository via GitHub Pull Request, including SKILL.md format requirements, quality rules…

AGPL-3.0Auto-check passedDevelopment

Install Contribute Skills Via PR

skills CLI
$ npx skills add NeuroAIHub/BrainPilot --skill contribute-skills-via-pr -a claude-code

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

GitHub CLI
$ gh skill install NeuroAIHub/BrainPilot contribute-skills-via-pr --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/NeuroAIHub/BrainPilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/skills/skills/01_Meta-Skills/contribute-skills-via-pr .claude/skills/contribute-skills-via-pr && 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
contribute-skills-via-pr
GitHub stars
1.1k
Token cost
~1.8k tokens
SKILL.md length
605 words
Files
1
Skills in repo
59
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Step-by-step guidance for contributing a new skill to the NeuroAIHub/awesomecognitiveandneuroscienceskills repository via GitHub Pull Request, including SKILL.md format requirements, quality rules…

  • Works in 3 steps: Check for Overlap → Write the SKILL.md → Submit via Git PR
  • Development work in your project
  • SKILL.md covers Purpose, When to Use This Skill, Research Planning Protocol and Verification Notice, plus 5 more sections
  • Calls git; reaches github.com

What it does

Contribute Skills Via PR is an agent skill from NeuroAIHub/BrainPilot. Step-by-step guidance for contributing a new skill to the NeuroAIHub/awesomecognitiveandneuroscienceskills repository via GitHub Pull Request, including SKILL.md format requirements, quality rules, and PR checklist

Its SKILL.md is about 1.8k 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 Development. It works with GitHub and Git. The repository describes itself as: BrainPilot: Automating Brain Discovery with Agentic Research. The licence is AGPL-3.0.

When your agent uses it

  • Development work in your project

Example prompts

  • “/contribute-skills-via-pr”

Workflow steps

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

  1. Check for Overlap
  2. Write the SKILL.md
  3. Submit via Git PR

What it can do on your machine

Read from SKILL.md and the folder at commit 93f6855. 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:

    • git

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    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

Contribute Skills Via PR loads about 1.8k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 605 words of instructions outside code blocks.

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

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 NeuroAIHub/BrainPilot at commit 93f6855, republished under its AGPL-3.0 licence (© NeuroAIHub). 605 words, ~1,847 tokens.

Download SKILL.mdSave it as .claude/skills/contribute-skills-via-pr/SKILL.md (or your agent's skills folder).
name
contribute-skills-via-pr
description
Step-by-step guidance for contributing a new skill to the NeuroAIHub/awesome_cognitive_and_neuroscience_skills repository via GitHub Pull Request, including SKILL.md format requirements, quality rules, and PR checklist
domain
community-contribution
version
1.0.0
authors
Claude (AI-assisted)
review_status
ai-generated

Contribute Skills via PR

Purpose

This skill encodes the complete workflow for contributing a new skill to the NeuroAIHub/awesome_cognitive_and_neuroscience_skills repository via GitHub Pull Request. It covers SKILL.md format requirements, quality rules enforced by maintainers, the PR submission process, and the no-Git alternative.

When to Use This Skill

Activate when the user:

  • Wants to contribute a skill to the NeuroAIHub community repository
  • Asks how to submit a PR to awesome_cognitive_and_neuroscience_skills
  • Wants to know the SKILL.md format or quality requirements for this repository
  • Asks about the review process or PR checklist for this repo

Research Planning Protocol

  1. State the contribution goal — What domain knowledge does the new skill encode? Is it a new skill, an improvement, or a verification?
  2. Check for overlap — Confirm the skill does not duplicate an existing one (see overlap checklist below).
  3. Declare the skill structure — Outline the sections and key parameters before writing.
  4. Note quality constraints — All numerical parameters need citations; no page numbers; under 500 lines.
  5. Present the plan and WAIT for user confirmation before writing the SKILL.md.

Verification Notice

This skill was generated by AI from direct inspection of the NeuroAIHub/awesome_cognitive_and_neuroscience_skills repository (April 2026). Repository requirements may change — always check the current CONTRIBUTING.md before submitting. If you find errors, please open an issue.

Step 1: Check for Overlap

Before writing, verify your skill does not duplicate an existing one. Current skills include (41 total):

eeg-preprocessing-pipeline-guide, erp-analysis, mne-python-guide, fmri-preprocessing-pipeline-guide, fmri-glm-analysis-guide, fmri-task-design-guide, brain-connectivity-modeler, neural-decoding-analysis, neural-population-analysis-guide, calcium-imaging-analysis-guide, lesion-symptom-mapping-guide, optogenetics-protocol-designer, spiking-network-model-builder, drift-diffusion-model, bayesian-cognitive-model-builder, act-r-model-builder, evidence-accumulation-selector, parameter-recovery-checker, signal-detection-analysis, cogsci-statistics, cogsci-power-analysis, cogsci-visualization, neuroimaging-power-guide, neuroimaging-sample-size-calculator, cognitive-paradigm-design, eeg-paradigm-designer, divergent-thinking-scoring, alternative-uses-task-designer, creativity-self-efficacy-mediation, reading-time-analysis, self-paced-reading-designer, sentence-stimulus-norming, infant-looking-time-designer, tom-task-selector, neuropsych-battery-selector, visual-search-array-generator, research-literacy, paper-to-skill, contribute-skill, verify-skill, share-case

Step 2: Write the SKILL.md

Required YAML Frontmatter

Skill name may only contain lowercase letters, numbers, and hyphens. The name must match the folder name.

yaml
---
name: "my-skill-name"
description: "One-sentence summary of the domain knowledge encoded"
domain: "your-domain"
version: "1.0.0"
authors:
  - "Your Name"
papers:
  - "Author et al., Year"
dependencies:
  required:
    - research-literacy
review_status: "ai-generated"
---

Mandatory fields: name, description, review_status. All others are recommended.

Required Sections (in this order)
  1. Purpose — What domain knowledge this skill encodes and why it is useful
  2. When to Use — Trigger conditions that activate this skill
  3. Research Planning Protocol — The standard 5-step preamble (copy template below)
  4. Verification Notice — The standard AI disclaimer (copy template below)
  5. Domain-specific content — The actual skill logic with cited parameters
Show full SKILL.md (238 more words)Show less
Research Planning Protocol Template
markdown
## Research Planning Protocol

1. **State the research question** — ...
2. **Justify the method choice** — ...
3. **Declare expected outcomes** — ...
4. **Note assumptions and limitations** — ...
5. **Present the plan to the user and WAIT for confirmation** before proceeding.
Verification Notice Template
markdown
## Verification Notice

> This skill was generated by AI from academic literature. All parameters,
> thresholds, and citations require independent verification before use in
> research. If you find errors, please open an issue at
> https://github.com/NeuroAIHub/awesome_cognitive_and_neuroscience_skills/issues.
Quality Rules
RuleRequirement
Skill nameLowercase letters, numbers, and hyphens only. Must match the folder name. e.g., my-new-skill
CitationsAll numerical parameters must have (Author, Year)
No page numbersUse (Luck, 2014) NOT (Luck, 2014, p. 187)
Line limitSKILL.md must be under 500 lines
Directory namekebab-case, must match the name field in YAML frontmatter
Commit prefixfeat:, fix:, docs:, or refactor:

Step 3: Submit via Git PR

bash
# 1. Fork on GitHub, then clone your fork
git clone https://github.com/<your-username>/awesome_cognitive_and_neuroscience_skills.git
cd awesome_cognitive_and_neuroscience_skills

# 2. Create a feature branch
git checkout -b feat/<skill-name>

# 3. Create skill directory and add files
mkdir -p skills/<skill-name>
# copy your SKILL.md into skills/<skill-name>/SKILL.md
# optionally: mkdir skills/<skill-name>/references

# 4. Commit and push
git add skills/<skill-name>/
git commit -m "feat: add <skill-name> skill for <one-line description>"
git push origin feat/<skill-name>

# 5. Open PR on GitHub against the master branch
PR Template Checklist

When opening the PR, all items must be checked:

  • SKILL.md has required YAML frontmatter (name, description, review_status)
  • Includes Research Planning Protocol section
  • Includes Verification Notice section
  • All numerical parameters have (Author, Year) citations
  • Citations do not contain specific page numbers
  • SKILL.md is under 500 lines
  • Directory name uses kebab-case
  • Commit messages use conventional prefixes (feat:, fix:, docs:, etc.)

Alternative: No-Git Contribution

If you prefer not to use Git, use the contribute-skill meta-skill inside Claude Code:

  1. Say "contribute a skill" in Claude Code
  2. The meta-skill generates a SKILL.md interactively
  3. It submits the skill as a GitHub Issue with the community-skill label
  4. Maintainers review and merge on your behalf

After Submission

Maintainers may request changes such as:

  • Adding missing (Author, Year) citations
  • Removing page numbers from citations
  • Reducing line count if over 500
  • Clarifying the Research Planning Protocol or Verification Notice

Use the verify-skill meta-skill to self-review your SKILL.md before submitting to catch common issues early.

© NeuroAIHub, AGPL-3.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 packages/skills/skills/01_Meta-Skills/contribute-skills-via-pr of NeuroAIHub/BrainPilot.

Open the folder on GitHubat commit 93f6855

Compare with similar skills

Contribute Skills Via PR 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.

Contribute Skills Via PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Contribute Skills Via PR this skillNeuroAIHub/BrainPilot1.1k—~1.8kAutomated safety check: PassAGPL-3.0
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0
Pull Request Title and Body Writeropeninterpreter/openinterpreter69k2 repos~1.1kAutomated safety check: PassApache-2.0
Draft Release Notesjamiepine/voicebox57k—~941Automated safety check: PassMIT
PR Review State Fetchprisma/orm48k—~767Automated safety check: PassApache-2.0

Similar skills

  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Pull Request Title and Body Writer

    openinterpreter/openinterpreter

    Rewrites the title and body of one or more pull requests with gh, leading with why the change was made, then what changed, and describing only the net result.

    69k GitHub starsUsed in 2 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Draft Release Notes

    jamiepine/voicebox

    Writes or refreshes the Unreleased section of CHANGELOG.md as a themed narrative built from the commits, PRs and diff since the last version tag.

    57k GitHub stars~941 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Official

    Fetches a pull request's canonical review state as JSON, validates it, and renders markdown, a text summary and triage target files from it using bundled scripts.

    48k GitHub stars~767 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Publishes curated, bilingual release notes for an existing Mole version tag with gh release edit, including contributor thanks and reactions, after the release workflow finishes.

    70k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed

More from NeuroAIHub/BrainPilot

All 59 skills in this repo
  • Deeplabcut

    NeuroAIHub/BrainPilot

    Toolbox for markerless animal pose estimation with DeepLabCut.

    1.1k GitHub stars~1.7k tokensUpdated 9 days ago
    Auto-check passed
  • Fmriprep

    NeuroAIHub/BrainPilot

    Preprocess task-based or resting-state fMRI data with fMRIPrep — a robust, BIDS-App preprocessing pipeline built on FSL, ANTs, FreeSurfer, AFNI, and Nilearn.

    1.1k GitHub stars~4.1k tokensUpdated 9 days ago
    Auto-check passed
  • Mne Python Guide

    NeuroAIHub/BrainPilot

    Domain-validated pipeline guidance for EEG/MEG data analysis using MNE-Python: data loading, preprocessing (filtering, ICA, re-referencing), epoching, ERP/ERF computation, time-frequency…

    1.1k GitHub stars~2.3k tokensUpdated 9 days ago
    Auto-check passed
  • Netneurotools Guide

    NeuroAIHub/BrainPilot

    Domain-validated guidance for network neuroscience analysis using netneurotools: datasets, brain network metrics, connectivity consensus, modularity, spatial statistics, null models, and cortical…

    1.1k GitHub stars~2.6k tokensUpdated 9 days ago
    Auto-check passed
  • Nature Figure

    NeuroAIHub/BrainPilot

    Submission-grade Nature/high-impact journal figure workflow for Python or R.

    1.1k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Pycortex Guide

    NeuroAIHub/BrainPilot

    Domain-validated guidance for cortical surface visualization and brain surface rendering of fMRI data using pycortex: data types (Volume, Vertex, Dataset), 2D cortical flatmaps, 3D WebGL brain…

    1.1k GitHub stars~1.6k tokensUpdated 9 days ago
    Auto-check passed

Works with

Categories

Questions about Contribute Skills Via PR

What does Contribute Skills Via PR do?

Step-by-step guidance for contributing a new skill to the NeuroAIHub/awesomecognitiveandneuroscienceskills repository via GitHub Pull Request, including SKILL.md format requirements, quality rules…. Contribute Skills Via PR is an agent skill from NeuroAIHub/BrainPilot.

When should I use Contribute Skills Via PR?

Contribute Skills Via PR fits situations like: development work in your project.

How do I install Contribute Skills Via PR in Claude Code?

Run `npx skills add NeuroAIHub/BrainPilot --skill contribute-skills-via-pr -a claude-code`. Or copy the skill folder (packages/skills/skills/01_Meta-Skills/contribute-skills-via-pr in NeuroAIHub/BrainPilot) into .claude/skills/contribute-skills-via-pr in your project. Claude Code loads it when a task matches its description.

How do I install Contribute Skills Via PR in Codex?

Run `npx skills add NeuroAIHub/BrainPilot --skill contribute-skills-via-pr -a codex`. Or copy the skill folder (packages/skills/skills/01_Meta-Skills/contribute-skills-via-pr in NeuroAIHub/BrainPilot) into .agents/skills/contribute-skills-via-pr in your project. Codex loads it when a task matches its description.

Can I use Contribute Skills Via PR 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 NeuroAIHub/BrainPilot --skill contribute-skills-via-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/contribute-skills-via-pr, .gemini/skills/contribute-skills-via-pr, .github/skills/contribute-skills-via-pr and .opencode/skills/contribute-skills-via-pr in your project.

What does Contribute Skills Via PR need to run?

Going by SKILL.md and its folder, Contribute Skills Via PR needs the command-line tools its instructions call (git).

Does Contribute Skills Via PR access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Contribute Skills Via PR 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 Contribute Skills Via PR use?

Contribute Skills Via PR is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Contribute Skills Via PR use?

About 1.8k tokens (SKILL.md is roughly 7.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 Contribute Skills Via PR?

Skills that share tags, products or a category with Contribute Skills Via PR: Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars), Create Pull Request (cline/cline, 70k stars), Pull Request Title and Body Writer (openinterpreter/openinterpreter, 69k stars) and Draft Release Notes (jamiepine/voicebox, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Contribute Skills Via PR?

NeuroAIHub (a GitHub organization) maintains it in NeuroAIHub/BrainPilot, which has 1,062 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on October 2, 2026.

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