Skip to content
Back to skills

Maintain Project Contributing

ASecurity

Maintain CONTRIBUTING.md as the contributor-facing member of the canonical four-document repository suite.

  • 7 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added September 5, 2026
ai-agentsrailsdocumentation

Security analysis

A100/100

Pro scans all 4 files and shows the line behind each finding

Scanned September 5, 2026

npx -y skills add gaelic-ghost/socket --skill maintain-project-contributing --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Maintain Project Contributing?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Maintain Project Contributing
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/gaelic-ghost-maintain-project-contributing/badge)](https://www.skillsdirectory.com/skills/gaelic-ghost-maintain-project-contributing)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: maintain-project-contributing
description: Maintain CONTRIBUTING.md as the contributor-facing member of the canonical four-document repository suite.
---

# Maintain Project Contributing

## Purpose

Keep `CONTRIBUTING.md` focused on human contributor setup, workflow,
verification, review, communication, and contribution terms while all four
canonical repository documents move together.

## Commands

The only documentation commands are:

```text
just docs-check
just docs-apply
```

Both always process README, CONTRIBUTING, AGENTS, and ROADMAP. There are no
per-file recipes and no supported direct script commands.

## Managed Contract

- `assets/document.contract.json` fixes the canonical structure and aliases.
- `assets/CONTRIBUTING.template.md` supplies deterministic bootstrap content.
- Repositories cannot customize headings, order, aliases, or fix policy.
- Healthy existing prose and allowed additional sections remain preserved.

## CONTRIBUTING Ownership

CONTRIBUTING owns who the guide serves, prerequisites, choosing work, making
changes, asking for review, runtime setup, development expectations, pull
request expectations, communication, and contribution terms. Product overview
belongs in README, durable agent policy in AGENTS, and planning in ROADMAP.

Placeholder checks ignore fenced examples, including generic DCO sign-off
examples. They apply only to prose that matches managed scaffold language.

## Deterministic Workflow

Use `just docs-check` for a no-write audit and `just docs-apply` for the atomic
four-document normalization transaction. Apply must be byte-idempotent.

## Guardrails

- Never maintain CONTRIBUTING separately from the full document suite.
- Never invent environment variables, services, commands, branch policy,
  review policy, or legal terms.
- Never expose project-local schema customization.
- Never commit, push, or open a pull request as part of documentation upkeep.

## References

- `assets/document.contract.json`
- `assets/CONTRIBUTING.template.md`

Files in this skill

  • SKILL.md2 KB
  • agents/openai.yaml495 B
  • assets/CONTRIBUTING.template.md2.1 KB
  • assets/document.contract.json1.4 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…