Data Classification
Classify data by sensitivity level for "$ARGUMENTS". Define classification levels, inventory data types, and establish handling requirements that protect data proportionate to its sensitivity.
Arguments. $ARGUMENTS may contain the project name and optional flags. Take the first token as <project> and treat --skip-checks as a flag; never include flags in file paths. All paths below use <project>. If --skip-checks is present, skip the prerequisite check and, before writing any artifact, append one line to .singularskills/log.jsonl: {"ts":"<ISO timestamp>","skill":"security-data-classification","workflow":"security","phase":1,"project":"<project>","event":"skipped","artifact":"01-identify.md","note":"<reason or \"none given\">"}.
Prerequisites
Part of a workflow. This skill is phase 1 (Identify) of the NIST CSF workflow (security); cross-domain workflows run it too. First check .singularskills/log.jsonl for an open run for this project: a run-started line with "project":"<project>" and no later run-finished line for the same workflow and project. If one exists, the conductor is running you: continue here. Otherwise, if the user asked to start, run, continue or resume a process or workflow rather than this one step, do not continue here: invoke the workflow skill with the workflow the user asked for, or security when they named none, followed by <project>; it runs this phase in order, asks before it writes and records the run. Otherwise continue here: a later phase runs on its own, behind its gate.
Run this skill's gate before writing: sh <this skill's folder>/scripts/gate.sh <project> <project root>, where <project root> is the folder that contains .singularskills/ (use . when you are already there). If it exits non-zero, stop and tell the user what it printed, unless --skip-checks was given (see Arguments). On a refusal, before you stop, append this line to .singularskills/log.jsonl (create the folder and file if missing): {"ts":"<ISO timestamp>","skill":"security-data-classification","workflow":"security","phase":1,"project":"<project>","event":"refused","artifact":"01-identify.md","note":"<what the gate printed>"}. Once the gate has passed, or under --skip-checks once you have appended the skipped line, append this line before you start work: {"ts":"<ISO timestamp>","skill":"security-data-classification","workflow":"security","phase":1,"project":"<project>","event":"started","artifact":"01-identify.md","note":""}.
Read .singularskills/security/<project>/00-govern.md. If this file does not exist, tell the user:
Phase 0 (Govern) has not been completed for "". Run a Govern skill first (e.g., /security-security-policy <project>), or use --skip-checks to bypass.
Process
Define classification levels:
- Public — information intended for public consumption; no impact if disclosed (marketing materials, public docs, open-source code)
- Internal — general business information not intended for public release; minor impact if disclosed (internal memos, org charts, non-sensitive reports)
- Confidential — sensitive business information; significant impact if disclosed (financial data, strategic plans, employee records, source code, customer lists)
- Restricted — highest sensitivity; severe impact if disclosed (credentials, encryption keys, PII/PHI/PCI data, trade secrets, security configurations)
Create classification criteria per level:
- For each level, define clear criteria to determine classification:
- What types of data belong at this level?
- What is the business impact of unauthorized disclosure?
- What is the regulatory impact?
- What is the reputational impact?
- Provide examples for each level to aid consistent classification decisions
- Define how to handle data that spans multiple levels (classify at the highest applicable level)
Inventory data types and classify each:
- Enumerate all data types the organization creates, processes, or stores
- For each data type, record: description, classification level, owner, storage locations, retention period
- Common data types to evaluate: customer PII, employee records, financial transactions, health information, authentication credentials, logs, analytics data, intellectual property, communications
Define handling requirements per level:
- For each classification level, specify requirements across:
- Storage — encryption at rest, access controls, approved storage locations
- Transmission — encryption in transit (TLS/mTLS), approved transfer methods, DLP controls
- Access — who can access, authentication requirements, need-to-know basis
- Retention — how long to keep, archival procedures, legal hold considerations
- Disposal — secure deletion methods, certificate of destruction, media sanitization
- Define escalating controls as sensitivity increases
Identify data with regulatory requirements:
- PII (Personally Identifiable Information) — GDPR, CCPA, state privacy laws
- PHI (Protected Health Information) — HIPAA, HITECH
- PCI (Payment Card Industry data) — PCI DSS requirements
- Financial data — SOX, GLBA requirements
- Map each regulated data type to: applicable regulations, specific requirements, compliance deadlines, penalties for non-compliance
Write the artifact — append to .singularskills/security/<project>/01-identify.md under a ## Data Classification section. Create the file with a # Identify — <project> heading if it does not exist; if a ## Data Classification section already exists, replace only that section. The section contains:
- Classification Levels — definitions, criteria, and examples per level
- Data Inventory — all data types with assigned classification and owner
- Handling Requirements — storage, transmission, access, retention, and disposal per level
- Regulatory Mapping — regulated data types with applicable frameworks and requirements
- Implementation Guidance — how to label, handle, and monitor classified data
Output
The data classification appended to .singularskills/security/<project>/01-identify.md. Present a summary to the user highlighting:
- Classification levels defined with key criteria
- Distribution of data types across classification levels
- Data types with regulatory requirements and applicable frameworks
- Critical handling requirements for Restricted and Confidential data
Record the run. After you have written your section, append this line to .singularskills/log.jsonl (the started line of Prerequisites, with "event":"finished"): {"ts":"<ISO timestamp>","skill":"security-data-classification","workflow":"security","phase":1,"project":"<project>","event":"finished","artifact":"01-identify.md","note":""}.
This artifact is shared by every skill of phase 1 (Identify). The frontmatter is written once, by whoever creates the file: if you create it, open it with the block below (skill is the phase title, started the time of that first write; gate is passed when the gate ran clean and skipped under --skip-checks); if it already exists, leave the block alone except to update finished and to set gate to the worst value among the sections (skipped over passed).
---
skill: Identify
workflow: security
phase: 1
project: <project>
started: <ISO timestamp>
finished: <ISO timestamp>
agent: <the agent you run in, or "unknown">
gate: <passed|skipped>
---
Open your ## Data Classification section with one italic line, *<skill name> · <ISO timestamp> · gate: <passed|skipped>* (your skill name is security-data-classification).
End your section with ### Decisions and ### Open questions (one level under your ## Data Classification heading, so the section stays one block), in this shape:
### Decisions
- <what was chosen> — <why> — <what was rejected>
### Open questions
- <what the next phase or a reviewer must settle>
End the artifact with this paragraph, verbatim:
Not a penetration test or audit. This artifact is generated analysis; validate findings against the live system and have material controls reviewed by a qualified security professional.
1---2name: security-data-classification3description: Classify an organization's data as public, internal, confidential or restricted — criteria, a data inventory, handling rules for storage, transfer, access, retention and disposal, and regulated types such as PII, PHI and card data. Use when the user asks which of their data is sensitive and how each kind must be stored, shared and deleted.4metadata:5 source: https://skillmd.com/skills/bromso/security-data-classification6 argument-hint: "[project] [--skip-checks]"7 workflow: security8 phase: 19 artifact: 01-identify.md10---1112# Data Classification1314Classify data by sensitivity level for "$ARGUMENTS". Define classification levels, inventory data types, and establish handling requirements that protect data proportionate to its sensitivity.1516**Arguments.** `$ARGUMENTS` may contain the project name and optional flags. Take the first token as `<project>` and treat `--skip-checks` as a flag; never include flags in file paths. All paths below use `<project>`. If `--skip-checks` is present, skip the prerequisite check and, **before writing any artifact**, append one line to `.singularskills/log.jsonl`: `{"ts":"<ISO timestamp>","skill":"security-data-classification","workflow":"security","phase":1,"project":"<project>","event":"skipped","artifact":"01-identify.md","note":"<reason or \"none given\">"}`.1718## Prerequisites1920**Part of a workflow.** This skill is phase 1 (Identify) of the NIST CSF workflow (`security`); cross-domain workflows run it too. First check `.singularskills/log.jsonl` for an open run for this project: a `run-started` line with `"project":"<project>"` and no later `run-finished` line for the same `workflow` and `project`. If one exists, the conductor is running you: continue here. Otherwise, if the user asked to start, run, continue or resume a process or workflow rather than this one step, do not continue here: invoke the `workflow` skill with the workflow the user asked for, or `security` when they named none, followed by `<project>`; it runs this phase in order, asks before it writes and records the run. Otherwise continue here: a later phase runs on its own, behind its gate.2122Run this skill's gate before writing: `sh <this skill's folder>/scripts/gate.sh <project> <project root>`, where `<project root>` is the folder that contains `.singularskills/` (use `.` when you are already there). If it exits non-zero, stop and tell the user what it printed, unless `--skip-checks` was given (see Arguments). On a refusal, before you stop, append this line to `.singularskills/log.jsonl` (create the folder and file if missing): `{"ts":"<ISO timestamp>","skill":"security-data-classification","workflow":"security","phase":1,"project":"<project>","event":"refused","artifact":"01-identify.md","note":"<what the gate printed>"}`. Once the gate has passed, or under `--skip-checks` once you have appended the `skipped` line, append this line before you start work: `{"ts":"<ISO timestamp>","skill":"security-data-classification","workflow":"security","phase":1,"project":"<project>","event":"started","artifact":"01-identify.md","note":""}`.2324Read `.singularskills/security/<project>/00-govern.md`. If this file does not exist, tell the user:2526> Phase 0 (Govern) has not been completed for "<project>". Run a Govern skill first (e.g., `/security-security-policy <project>`), or use `--skip-checks` to bypass.2728## Process29301. **Define classification levels:**31 - **Public** — information intended for public consumption; no impact if disclosed (marketing materials, public docs, open-source code)32 - **Internal** — general business information not intended for public release; minor impact if disclosed (internal memos, org charts, non-sensitive reports)33 - **Confidential** — sensitive business information; significant impact if disclosed (financial data, strategic plans, employee records, source code, customer lists)34 - **Restricted** — highest sensitivity; severe impact if disclosed (credentials, encryption keys, PII/PHI/PCI data, trade secrets, security configurations)35362. **Create classification criteria per level:**37 - For each level, define clear criteria to determine classification:38 - What types of data belong at this level?39 - What is the business impact of unauthorized disclosure?40 - What is the regulatory impact?41 - What is the reputational impact?42 - Provide examples for each level to aid consistent classification decisions43 - Define how to handle data that spans multiple levels (classify at the highest applicable level)44453. **Inventory data types and classify each:**46 - Enumerate all data types the organization creates, processes, or stores47 - For each data type, record: description, classification level, owner, storage locations, retention period48 - Common data types to evaluate: customer PII, employee records, financial transactions, health information, authentication credentials, logs, analytics data, intellectual property, communications49504. **Define handling requirements per level:**51 - For each classification level, specify requirements across:52 - **Storage** — encryption at rest, access controls, approved storage locations53 - **Transmission** — encryption in transit (TLS/mTLS), approved transfer methods, DLP controls54 - **Access** — who can access, authentication requirements, need-to-know basis55 - **Retention** — how long to keep, archival procedures, legal hold considerations56 - **Disposal** — secure deletion methods, certificate of destruction, media sanitization57 - Define escalating controls as sensitivity increases58595. **Identify data with regulatory requirements:**60 - **PII (Personally Identifiable Information)** — GDPR, CCPA, state privacy laws61 - **PHI (Protected Health Information)** — HIPAA, HITECH62 - **PCI (Payment Card Industry data)** — PCI DSS requirements63 - **Financial data** — SOX, GLBA requirements64 - Map each regulated data type to: applicable regulations, specific requirements, compliance deadlines, penalties for non-compliance65666. **Write the artifact** — append to `.singularskills/security/<project>/01-identify.md` under a `## Data Classification` section. Create the file with a `# Identify — <project>` heading if it does not exist; if a `## Data Classification` section already exists, replace only that section. The section contains:6768 - **Classification Levels** — definitions, criteria, and examples per level69 - **Data Inventory** — all data types with assigned classification and owner70 - **Handling Requirements** — storage, transmission, access, retention, and disposal per level71 - **Regulatory Mapping** — regulated data types with applicable frameworks and requirements72 - **Implementation Guidance** — how to label, handle, and monitor classified data7374## Output7576The data classification appended to `.singularskills/security/<project>/01-identify.md`. Present a summary to the user highlighting:77- Classification levels defined with key criteria78- Distribution of data types across classification levels79- Data types with regulatory requirements and applicable frameworks80- Critical handling requirements for Restricted and Confidential data8182**Record the run.** After you have written your section, append this line to `.singularskills/log.jsonl` (the `started` line of Prerequisites, with `"event":"finished"`): `{"ts":"<ISO timestamp>","skill":"security-data-classification","workflow":"security","phase":1,"project":"<project>","event":"finished","artifact":"01-identify.md","note":""}`.8384This artifact is shared by every skill of phase 1 (Identify). The frontmatter is written once, by whoever creates the file: if you create it, open it with the block below (`skill` is the phase title, `started` the time of that first write; `gate` is `passed` when the gate ran clean and `skipped` under `--skip-checks`); if it already exists, leave the block alone except to update `finished` and to set `gate` to the worst value among the sections (`skipped` over `passed`).8586```yaml87---88skill: Identify89workflow: security90phase: 191project: <project>92started: <ISO timestamp>93finished: <ISO timestamp>94agent: <the agent you run in, or "unknown">95gate: <passed|skipped>96---97```9899Open your `## Data Classification` section with one italic line, `*<skill name> · <ISO timestamp> · gate: <passed|skipped>*` (your skill name is `security-data-classification`).100101End your section with `### Decisions` and `### Open questions` (one level under your `## Data Classification` heading, so the section stays one block), in this shape:102103```markdown104### Decisions105- <what was chosen> — <why> — <what was rejected>106107### Open questions108- <what the next phase or a reviewer must settle>109```110111End the artifact with this paragraph, verbatim:112113> **Not a penetration test or audit.** This artifact is generated analysis; validate findings against the live system and have material controls reviewed by a qualified security professional.