blackoutsecure/Blackout Secure Marketplace Kit

Pre-publish validator for GitHub Marketplace Actions. Lints metadata, branding, naming, and security defaults.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jun 8, 2026
License
Apache 2.0

Pinned Snippet

workflow.ymlSHA-pinned
uses: blackoutsecure/bos-marketplace-kit@33472b3595a0381843093da9f6640c1b7a5a303a # v0.1.9

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
action_yml_pathPath to the action manifest. Default `action.yml`.noaction.yml
fail_on_warning`true` to treat OP### warnings as failures.nofalse
skip_checksComma-separated check IDs to skip (e.g. `OP003,SC002`).no""
workflow_dirWorkflow directory to scan. Set "" to skip.no.github/workflows
github_tokenToken used for org-health API lookups. Defaults to `github.token`; set explicitly to use a PAT/fine-grained token with cross-repo contents:read.no${{ github.token }}
org_health_repo`owner/repo` containing fallback community-health files (e.g. `blackoutsecure/.github`). Defaults to `${owner}/.github` if empty.no""
check_org_health`true` to enable org-health lookups for CH### rules.notrue
require_securityCH001 severity: 'fail', 'warn', or 'skip'.nowarn
require_code_of_conductCH002 severity: 'fail', 'warn', or 'skip'.nowarn
require_contributingCH003 severity: 'fail', 'warn', or 'skip'.nowarn
require_supportCH004 severity: 'fail', 'warn', or 'skip'.noskip
require_issue_templatesCH005 severity: 'fail', 'warn', or 'skip'.noskip
require_pr_templateCH006 severity: 'fail', 'warn', or 'skip'.noskip
require_fundingCH### funding severity: 'fail', 'warn', or 'skip'.noskip
community_health_sourceGlobal source mode: 'local', 'inherit', or 'either'.noeither
security_sourceSC003 source override (or empty to use global).no""
code_of_conduct_sourceCH001 source override (or empty to use global).no""
contributing_sourceCH002 source override (or empty to use global).no""
support_sourceCH003 source override (or empty to use global).no""
issue_templates_sourceCH004 source override (or empty to use global).no""
pr_template_sourceCH005 source override (or empty to use global).no""
funding_sourceCH006 source override (or empty to use global).no""
auto_generate_missing[FUTURE] When `true`, use an LLM to draft missing community-health files and open a PR. Stub today; reserved for a future release.nofalse
require_dependabotDP001 severity: 'fail', 'warn', or 'skip'.nowarn
require_codeqlCQ001 severity: 'fail', 'warn', or 'skip'.nowarn
require_editorconfigLT001 severity: 'fail', 'warn', or 'skip'.nowarn
require_gitattributesLT002 severity: 'fail', 'warn', or 'skip'.nowarn
require_gitignoreLT003 severity: 'fail', 'warn', or 'skip'.nowarn
require_markdownlintLT004 severity: 'fail', 'warn', or 'skip'.noskip
require_yamllintLT005 severity: 'fail', 'warn', or 'skip'.noskip
require_ghas_code_scanningGH001 severity: 'fail', 'warn', or 'skip'.nowarn
require_ghas_secret_scanningGH002 severity: 'fail', 'warn', or 'skip'.nowarn
require_dependabot_alertsGH003 severity: 'fail', 'warn', or 'skip'.nowarn
require_security_devopsMS001 severity: 'fail', 'warn', or 'skip'.noskip
require_scorecardSR001 severity: 'fail', 'warn', or 'skip'.noskip
require_repo_descriptionRM001/RM002 severity (repo About-box description): 'fail', 'warn', or 'skip'.nowarn
require_repo_homepageRM003 severity (repo About-box homepage URL): 'fail', 'warn', or 'skip'. Malformed URLs always fail.noskip
require_repo_topicsRM004/RM005 severity (repo About-box topics): 'fail', 'warn', or 'skip'. Format violations and >20 topics always fail.nowarn
repo_description_max_lengthHard upper bound for the repo description (RM002). Default 350 (GitHub limit).no350
repo_description_min_lengthLower bound below which the repo description triggers a warning (RM002). Default 30. Set 0 to disable.no30
namedescription
passedNumber of checks that passed.
failedNumber of checks that failed.
warningsNumber of warnings.
reportNewline-separated `id|status|message` rows.