About enterprise-readiness
An assessment skill for maintainers evaluating production and enterprise readiness. It scores security and development practices, identifies gaps, guides fixes, and verifies the results.
Key features
- 01Readiness scoring and checklists
- 02CI/CD and workflow hardening
- 03Supply-chain security checks
- 04OpenSSF and OSPS assessment
- 05Gap analysis and fix verification
Use cases
- 01Assess a public project's enterprise readiness
- 02Review CI workflow permissions and actions
- 03Prepare evidence for security badges
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ netresearch/ enterprise-readiness-skill --skill enterprise-readinessAfter installing, type/enterprise-readinessin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
checkpoints.yamlevals/evals.jsonreferences/2fa-enforcement.mdbadge-display.mdbadge-submission-api.mdbadges-and-workflows.mdbestpractices-json.mdbranch-coverage.mdci-docker-worktree.mdci-patterns.mdcode-review.mdcve-workflow.mddco-implementation.mddynamic-analysis.mdgeneral.mdgithub.mdgo.mdharden-runner-guide.mdmandatory-requirements.mdnpm-pnpm-supply-chain.mdopenssf-badge-baseline.mdopenssf-badge-gold.mdopenssf-badge-silver.mdpython-pip-supply-chain.mdquick-start-guide.mdreproducible-builds.mdscorecard-playbook.mdsecurity-hardening.mdsigned-releases.mdslsa-provenance.mdDetails
From the project READMEEnterprise Readiness Assessment
Production/enterprise tier only — see
references/tier-framing.md.
When to Use
- Production/enterprise readiness evaluations
- Supply chain security: SLSA provenance, cosign signing, SBOMs
- CI/CD hardening, workflow permissions
- OpenSSF Best Practices (Passing/Silver/Gold), OSPS Baseline (L1/2/3)
- Scorecard optimization (Token-Permissions, Branch-Protection, Pinned-Deps)
- Code review, ADRs, changelogs, SECURITY.md
Assessment Workflow
- Discovery: Identify platform, languages, existing CI/CD, dependabot.yml; check the required root
.bestpractices.jsonfor maintained public projects (scope and validation:references/bestpractices-json.md, ER-74/ER-75). - Scoring: Apply checklists; check Scorecard, badge criteria, coverage
- Gap Analysis: List missing controls by severity
- Implementation: Apply fixes (SHA-pin actions, harden permissions, add workflows)
- Verification: Re-score and compare
Mandatory Workflows & Badges
Required coverage: CI, CodeQL, Scorecard, dependency review, composer audit, SBOM — as dedicated workflows or jobs calling the netresearch reusable. Badges: CI, Codecov, Scorecard, Best Practices, Baseline. See references/badges-and-workflows.md.
Maintained public projects MUST include an evidence-backed .bestpractices.json at the repository root, even before badge registration. Create or refresh it from the project's own evidence; omit unknowns. The file proposes answers and does not register a project, save the questionnaire or award a badge. See references/bestpractices-json.md.
Key Hardening Patterns
- Permissions: Declare
permissions: contents: readat workflow-level; grant write only per-job - SHA pinning: Third-party actions pinned to SHA with version comment (
# v4.2.0). Org-internal reusable workflows use@main - Harden-Runner:
step-security/harden-runneras first step in every job; preferegress-policy: blockwith allowed-endpoints - Dependabot: Configure
dependabot.ymlwith all ecosystems (composer,npm,github-actions,docker); set up auto-merge workflow for dependency PRs usingpull_request_target - Coverage: Upload via
codecov-action; configurecodecov.ymlwith patch coverage threshold - Duplicate CI prevention: Scope
push:trigger tobranches: [main]whenpull_request:is also present - SLSA provenance: Use
actions/attest-build-provenancewithid-token: writeandattestations: writepermissions; verify withgh attestation verify. That is Level 2 in the project's own workflow; Level 3 needs checkout, build and attestation all inside one org reusable the project cannot edit — seereferences/slsa-provenance.md - Security policy: Create
SECURITY.mdwith vulnerability disclosure process and response SLA (Critical: 7 days, High: 30 days)
Critical Rules
- NEVER interpolate
${{ github.event.* }}or${{ inputs.* }}inrun:blocks (script injection) - NEVER guess action versions -- fetch from GitHub API and verify SHA against tags
- ALWAYS include
https://URLs in badge justifications - ALWAYS configure auto-merge for repos with Dependabot/Renovate
References
| Reference | Use |
|---|---|
references/general.md | Always |
references/scorecard-playbook.md | Scorecard optimization |
references/badges-and-workflows.md | Badge URLs, workflows |
references/mandatory-requirements.md | Checklist |
references/ci-patterns.md | CI/CD, hooks |
references/code-review.md | PR quality and verification claims |
references/slsa-provenance.md | SLSA Level 3 |
references/signed-releases.md | Cosign/GPG |
references/openssf-badge-silver.md | Silver |
references/openssf-badge-gold.md | Gold |
references/openssf-badge-baseline.md | OSPS Baseline |
references/bestpractices-json.md | .bestpractices.json: pre-fill badge answers from the repo |
references/harden-runner-guide.md | Harden-Runner |
references/solo-maintainer-guide.md | Solo-maintainer criteria |
references/npm-pnpm-supply-chain.md | pnpm, npm ci, npx, lockfile, Node tooling in a CI job (Sonar S8543/S6505, CodeQL path-injection) |
references/python-pip-supply-chain.md | pip |
Related skills: go-development, github-project, security-audit, git-workflow.