Skip to content

prepare-github-project

skillLast commit

Agent skill for auditing and preparing professional GitHub repositories, metadata, topics, community files, security, and CI.

Open productSource
Role
Agent workflow design and automation engineering
Scope
Agent workflow, validation automation, and packaging
Status
Published npm package

Problem

A codebase can be technically ready while its Git identity, metadata, security guidance, community files, secret hygiene, and CI do not support professional public collaboration.

Constraints

  1. C1

    Visibility, repository creation, branch/settings changes, and pushes are external mutations.

  2. C2

    Licenses and homepage URLs cannot be assumed.

  3. C3

    Partial remote success must not trigger destructive compensation.

Architecture

Local manifest/Git/community/workflow auditor; metadata and preparation rules; authorization-gated GitHub CLI/API actions with read-back verification.

01

Skill workflow

Local manifest/Git/community/workflow auditor.

02

Automation

Metadata and preparation rules.

03

Verification

Authorization-gated GitHub CLI/API actions with read-back verification.

Decisions

D1

Separate local readiness edits from remote mutations

Separate local readiness edits from remote mutations.

D2

Require an explicit visibility/license choice

Require an explicit visibility/license choice instead of defaults.

D3

Verify remote settings and SHAs after changes

Verify remote settings and SHAs after changes rather than trusting mutation responses alone.

Contribution

  • Built recognized-manifest/community/CI/secret-name inventory.
  • Encoded description/homepage/topic/default-branch guidance.
  • Designed safe local preparation and remote authorization boundaries.
  • Added read-back and partial-success reporting.

Outcomes

  • Agents can identify readiness gaps.
  • Prepare factual community and CI materials.
  • Propose accurate repository metadata.
  • Create/configure a repository only when authorized and verify the resulting state.

Verified stack

  • Agent Skills
  • JavaScript
  • Node.js
  • npm
  • GitHub Actions
  • CI/CD
  • Git

Working through something similar?

Share your challenge, scope, and timeline to start a focused conversation.