Research Group Skill Monorepo

This repository is a private skill registry for research-group workflows used by coding agents. It is not a standalone skill: each skill lives under skills/<skill-id>/ with its own SKILL.md, local documentation, templates, workflows, examples, and agent instructions.

Repository purpose

Use this repository to maintain shared, reviewable skills for group work while keeping sensitive research material out of version control. The repository should contain generalized workflows, sanitized examples, rubrics, templates, and governance docs. It must not contain private datasets, papers, review-platform material, tokens, credentials, confidential logs, or machine-specific local paths.

Layout contract

.
  README.md                 # registry and onboarding entry point
  AGENTS.md                 # repository-wide coding-agent rules
  CONTRIBUTING.md           # contribution and review workflow
  CODEOWNERS                # Gitea-compatible ownership rules
  LICENSE                   # repository license
  .gitignore                # privacy and bulk-artifact ignore rules
  docs/                     # repository governance and setup docs
  .gitea/                   # private Gitea issue and pull request templates
  skills/
    README.md               # canonical skill index
    <skill-id>/
      SKILL.md              # authoritative skill workflow
      AGENTS.md             # optional skill-specific agent rules
      README.md             # skill-local user guide
      templates/            # skill-local reusable templates
      scripts/              # skill-local helper scripts
      workflows/            # skill-local supporting workflows
      rubrics/              # skill-local evaluation rubrics
      examples/             # sanitized examples only

Keep skill-specific assets co-located with their skill. Do not add shared copies of skill templates or workflows at the repository top level unless they are truly repository governance documents.

Finding and invoking a skill

1. Start with the canonical index in skills/README.md.
2. Open the selected skill directory and read its SKILL.md before using or editing it.
3. Follow any skill-local AGENTS.md when using coding agents.
4. Invoke the skill by name or point the agent at the skill directory.
5. When updating a skill, update the skill-local README and the registry index if the name, purpose, status, or ownership changes.

Current skills

See the canonical skill index: skills/README.md.

Privacy rules

• Commit only generalized workflow material, sanitized examples, reusable templates, and governance documentation.
• Do not commit private papers, private datasets, private repositories, raw review material, author identities, review-platform exports, tokens, credentials, unredacted logs, or local filesystem paths.
• Use placeholders in examples and templates where group-specific names, URLs, or access policies would otherwise appear.
• Redact confidential logs before moving them into any shareable repository.
• Ask before publishing, pushing to a new remote, contacting authors, filing public issues, deleting upstream material, or changing access permissions.

Contributing and private Gitea setup

• Follow CONTRIBUTING.md for skill-change workflow, evidence requirements, privacy checks, and review expectations.
• Follow docs/skill-authoring.md when adding or reorganizing skills.
• Follow docs/agent-harness-compatibility.md for how Claude Code, Codex, Gemini CLI, Cursor, and GitHub Copilot use this repository through AGENTS.md.
• Follow docs/gitea-setup.md to host this repository in a private Gitea organization with protected branches, CODEOWNERS-style review expectations, and private PR/issue templates.