Contribute Skill

Contribute Skill

Purpose

This meta-skill lets researchers contribute new domain knowledge skills to the repository without needing Git expertise. It generates a properly formatted SKILL.md from the user's domain knowledge and submits it as a GitHub Issue for maintainer review.

When to Use This Skill

Activate when the user:

• Says "contribute a skill", "把这个方法做成 skill", "submit a new skill"
• Wants to turn a discussion about methodology into a reusable skill
• Has domain expertise they want to encode as a structured skill
• Wants to contribute a skill from a paper they are reading

Research Planning Protocol

Before starting the contribution process, you MUST:

1. Identify the knowledge source — Where does this domain knowledge come from? (paper, personal expertise, current session)
2. Confirm domain specificity — Does this knowledge pass the litmus test: "Would a competent programmer who has never taken a cognitive science course get this wrong?"
3. Outline the expected skill structure — What sections and parameters will the skill contain?
4. Note potential gaps — What information might be missing or need verification?
5. Present the contribution plan to the user and WAIT for confirmation before proceeding.

For detailed methodology guidance, see skills/research-literacy/SKILL.md.

⚠️ 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.

Prerequisites

This skill supports two submission methods:

1. Direct submission via gh CLI (Recommended)

   • Requires gh CLI installed and authenticated
   • Run gh auth status to check
   • Install from https://cli.github.com/ and run gh auth login

2. Manual submission via web browser

   • No gh CLI required
   • Opens GitHub Issues page in browser
   • User copies and pastes the generated content

The skill will check for gh availability and let the user choose their preferred method.

Interactive Flow

Step 1 — Source Confirmation

Q1: Where does this knowledge come from?

• A specific paper (provide DOI or title)
• Personal research experience
• Current session discussion
• Textbook or guidelines document
• Other (free text)

Q2: What is the skill about? (free text — brief description of the methodology)

Q3: Suggested skill name?

• Auto-suggest a kebab-case name based on the description
• Let the user confirm or modify

If the source is a paper with DOI/title, check whether the paper-to-skill meta-skill would be more appropriate. If the user has the full paper available, suggest: "Since you have the full paper, the paper-to-skill skill can do a more thorough extraction. Would you like to use that instead?"

Step 2 — Content Generation

Generate a SKILL.md following the project conventions. The generated skill MUST include:

YAML Frontmatter:

---
name: "[Human-Readable Skill Name]"
description: "[One-sentence summary]"
domain: "[subdomain]"
version: "1.0.0"
review_status: "ai-generated"
papers:
  - "[Author, Year]"
dependencies:
  required:
    - research-literacy
---

Required Sections (in order):

1. Purpose — What domain knowledge this skill encodes

2. When to Use This Skill — Trigger conditions

3. Research Planning Protocol — Standard preamble (adapt from template):

   ## Research Planning Protocol
   
   Before executing the domain-specific steps below, you MUST:
   
   1. **State the research question** — What specific question is this analysis/paradigm addressing?
   2. **Justify the method choice** — Why is this approach appropriate? What alternatives were considered?
   3. **Declare expected outcomes** — What results would support vs. refute the hypothesis?
   4. **Note assumptions and limitations** — What does this method assume? Where could it mislead?
   5. **Present the plan to the user and WAIT for confirmation** before proceeding.
   
   For detailed methodology guidance, see `skills/research-literacy/SKILL.md`.

4. Verification Notice — Standard disclaimer:

   ## ⚠️ 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](https://github.com/HaoxuanLiTHUAI/awesome_cognitive_and_neuroscience_skills/issues).

5. Domain-specific content — The actual skill logic with:

   • Key parameters (every number cited with Author, Year — no page numbers)
   • Decision logic
   • Common pitfalls
   • Step-by-step methodology

Content Quality Rules:

• Every numerical parameter must have a citation (Author, Year)
• No page numbers in citations (high hallucination risk)
• Skill must pass the litmus test: domain-specific, not general programming advice
• Under 500 lines total
• If content exceeds 500 lines, split into SKILL.md + references/ subdirectory