agentleFS
briiirussellbriiirussell/cybersecurity-skills/skills/security-start/SKILL.md

security-start

Skill489 starsChanged 5 days agoMITView on GitHub

Start here when a security ask is vague and no specific skill fits yet. Asks two or three questions about what you have (source code, a live site, a cloud setup, logs, a suspicious file, an auditor's request) and what's going on (building, shipping, an active incident, a compliance deadline), then hands off to the right skill or skills from this catalog, in order. It does no auditing itself. Use when the user says things like 'make this secure,' 'is this secure,' 'where do I start with security,' 'which security skill should I use,' 'security checkup,' 'what do we check,' 'secure my startup,' or 'help me with security' without naming a framework, a target or a tool. If the ask already names one (OWASP, a CVE, a workflow file, SOC 2, a phishing email, a pasted finding), use that skill directly instead.

  • Reads credentials

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read-only. This skill reads file names and manifests in the current repo to decide.

    line 27
  2. Distinctive:

    If there's a repo, spend a minute on it before asking anything:

    line 37
  3. Distinctive:

    Only ask what Step 1 didn't answer:

    line 49
  4. Distinctive:

    If two rows fit, pick the one closest to real evidence: code over policy, the deployed thing over the diagram.

    line 103
  5. Distinctive:

    Never route an offensive skill without saying it needs written authorization for the target.

    line 126
  6. Distinctive:

    If nothing in the catalog fits, say so plainly rather than stretching a skill.

    line 127

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Security Start — Pick the Right Skill

Some security asks arrive with no shape: "make this secure", "where do I start?". This skill turns one into a plan of one to three skills from this catalog, in order, and then gets out of the way. It doesn't audit anything itself.

Cross-references: every skill in the table below. The README's "Where to start" section is the long-form version of this table.

When to use

  • The ask is vague: "is my app secure?", "help me with security", "what should we check first?"
  • The user doesn't know which of the skills applies, or asks which one to use
  • A quick look at the repo is enough to decide (package.json, Dockerfile, .github/workflows/, Terraform, an .apk)

Not for: any ask that already names its subject. Route those straight to the owning skill without this one: a pasted finding → finding-triage; a CVE → vuln-research; "OWASP audit" → owasp-audit; a workflow file → cicd-security; "SOC 2" → control-audit; "we've been hacked" → incident-triage.

Authorization

  • Read-only. This skill reads file names and manifests in the current repo to decide; it doesn't run tools or touch any system.
  • The skills it hands off to carry their own authorization checks. Offensive skills (recon, osint-recon, web-pentest, red-team-engagement, business-logic-testing) need written authorization for the target. Say so when routing to them.

Workflow

Step 1 — Look before asking

If there's a repo, spend a minute on it before asking anything:

ls; ls .github/workflows 2>/dev/null
ls package.json requirements.txt pyproject.toml go.mod Cargo.toml Gemfile pom.xml 2>/dev/null
ls Dockerfile docker-compose.yml *.tf k8s helm 2>/dev/null

Note the language, frameworks, whether there's an API, CI, containers, IaC, an AI feature, a mobile app.

Step 2 — Ask at most three questions

Only ask what Step 1 didn't answer:

  1. What do you have? Source code, a deployed app you're allowed to test, cloud accounts, logs, a single finding, a suspicious file, a regulation or an auditor.
  2. What's happening? Building something new, about to ship, an incident right now, a CVE wave, an audit date, general worry.
  3. Who's it for? Just you, your engineers, or a board, a customer or an auditor.

An active incident skips the questions: go straight to incident-triage.

Step 3 — Route

Pick from the table. Most asks need one skill, some two or three in sequence. Prefer the cheapest first step that gives real evidence.

SituationStart withThen
Active incident, breach, ransomware, account takeoverincident-triagedisk-forensics, malware-triage, security-comms
A suspicious file, attachment or binarymalware-triageincident-triage if it ran
"Is my app secure?" with source codeowasp-auditapi-audit (APIs), dependency-audit, secrets-audit
An API (REST / GraphQL / RPC)api-auditbusiness-logic-testing for money flows
Dependencies, CVEs in packagesdependency-auditvuln-research for one CVE, patch-sweep for many repos
One specific CVEvuln-researchpatch-sweep
GitHub Actions or other CIcicd-securitysecrets-audit
Leaked keys, .env worriessecrets-auditiam-audit for rotation and scope
C, C++ or Rust codenative-code-reviewfuzzing-harness
Parsers or decoders that take untrusted bytesfuzzing-harnessnative-code-review
Crypto code, tokens, signaturescrypto-audit
A mobile appmobile-auditapi-audit for its backend
An AI feature, LLM or agent in the productprompt-injectionai-risk-management for governance
The AI coding agents, skills, MCP servers you useagent-supply-chain-auditpersonal-opsec
Cloud accounts or PaaS (Vercel, Heroku, ...)cloud-auditiam-audit, container-audit
Docker or Kubernetescontainer-auditcloud-audit
Identity, SSO, rolesiam-audit
A live app to test (authorized)reconweb-pentest, business-logic-testing
Adversary emulation program (authorized)red-team-engagement
Investigation from public sources (authorized)osint-recon
New feature or system designthreat-modelingowasp-audit once it's built
Scanners in CIscanner-pipelinefinding-triage
A finding to triagefinding-triagevariant-analysis for siblings
A bug that probably exists elsewherevariant-analysisscanner-pipeline to keep the rule
Logs but no SIEMlog-watchsiem-detection later
Detection rules, SIEMsiem-detectionthreat-hunting
Hunting for something that didn't alertthreat-huntingsiem-detection
Running a SOCsoc-operations
GDPR / CCPA / privacyprivacy-engineering
Health data (HIPAA)hipaa-auditprivacy-engineering
Payment cards (PCI DSS)pci-audit
SOC 2, ISO 27001, FedRAMP auditcontrol-auditcsf-mapping for crosswalks
Building a security program, board posturecsf-mappingsecurity-comms
Learning from public breachesbreach-patternsthe audit skill each lesson points at
The founder's own accounts and devicespersonal-opsecsecrets-audit
Explaining security work to non-security peoplesecurity-comms

If two rows fit, pick the one closest to real evidence: code over policy, the deployed thing over the diagram.

Step 4 — Hand off

Say which skill comes first and why in one line, then the next steps. Start the first skill straight away if the user agrees. Don't summarize what the skills will find.

Output Format

## Security start
**What you have:** [source / live app / cloud / logs / file / audit]   **What's happening:** [situation]

1. `skill-name` — [why this first, one line]
2. `skill-name` — [what it adds after step 1]
3. `skill-name` — [optional]

[One line on authorization, if any step is offensive.]

Boundaries

  • Routing only. No findings, no severities, no tool runs.
  • Never route an offensive skill without saying it needs written authorization for the target.
  • If nothing in the catalog fits, say so plainly rather than stretching a skill.

References

  • README "Where to start" and the skill map (this table is a condensed version)
  • Router skills elsewhere informed the shape: obra/superpowers using-superpowers (MIT), addyosmani/agent-skills using-agent-skills (MIT), and the foundation skill in coreyhaines31/marketingskills (MIT). Paraphrased, nothing copied.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.