Customization

Before executing, check for user customizations at: ~/.claude/skills/CORE/USER/SKILLCUSTOMIZATIONS/System/

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

System Skill

System validation, integrity audits, documentation tracking, and security scanning for the PAI system.

Visibility

This skill runs in the foreground so you can see all output, progress, and hear voice notifications as work happens. Documentation updates, integrity checks, and other system operations should be visible to maintain transparency.

Voice Notification

When executing a workflow, do BOTH:

Send voice notification:

curl -s -X POST http://localhost:8888/notify \
  -H "Content-Type: application/json" \
  -d '{"message": "Running WORKFLOWNAME workflow from System skill"}' \
  > /dev/null 2>&1 &

Output text notification:

Running the **WorkflowName** workflow from the **System** skill...

Workflow Routing

Core Operations (The Four)

Workflow	Trigger	Purpose	File
IntegrityCheck	"integrity check", "audit system", "check references", "system health"	Find and fix broken references across the system	`Workflows/IntegrityCheck.md`
DocumentSession	"document session", "document today", "document this session", "log session"	Document current session's work from transcript	`Workflows/DocumentSession.md`
DocumentRecent	"document recent", "catch up docs", "what's undocumented", "document since last update"	Catch-up documentation for changes since last documented update	`Workflows/DocumentRecent.md`
GitPush	"git push", "commit and push", "push changes", "push to repo"	Git commit + push to private PAI repo	`Workflows/GitPush.md`

Composition Rules:

Integrity Check → may produce fixes → Document Session → Git Push
After any session → Document Session → Git Push
Periodic catch-up → Document Recent → Git Push

Security Workflows

Workflow	Trigger	File
SecretScanning	"check for secrets", "scan for credentials", "security scan"	`Workflows/SecretScanning.md`
CrossRepoValidation	"cross-repo validation", "check for leaks"	`Workflows/CrossRepoValidation.md`
PrivacyCheck	"privacy check", "check for sensitive data", "data isolation"	`Workflows/PrivacyCheck.md`

Utility Workflows

Workflow	Trigger	File
WorkContextRecall	"we just worked on", "what did we do with", "remember when we", "didn't we already"	`Workflows/WorkContextRecall.md`

Note: For public PAI integrity ("check PAI integrity", "audit PAI packs"), use the PAI skill → PAIIntegrityCheck.md

Examples

Core Operations

Example 1: Integrity Check

User: "Run an integrity check"
→ Invokes IntegrityCheck workflow
→ Spawns parallel agents to audit ~/.claude
→ Finds broken references, missing files
→ Returns list of issues found/fixed

Example 2: Document Current Session

User: "Document this session"
→ Invokes DocumentSession workflow
→ Reads current session transcript
→ Uses AI to extract what changed and why
→ Creates entry in MEMORY/PAISYSTEMUPDATES/
→ Automatically calls GitPush

Example 3: Catch-up Documentation

User: "What's undocumented? Catch up the docs."
→ Invokes DocumentRecent workflow
→ Finds last documented update timestamp
→ Compares git history since then
→ Generates documentation for missed changes
→ Automatically calls GitPush

Example 4: Git Push

User: "Git Push"
→ Invokes GitPush workflow
→ Verifies we're in ~/.claude (PRIVATE repo)
→ git add + commit + push

Security Workflows

Example 5: Secret Scanning

User: "Check for secrets before I push"
→ Invokes SecretScanning workflow
→ Runs TruffleHog on specified directory
→ Reports any API keys, credentials found

Example 6: Cross-Repo Validation

User: "Make sure nothing leaked to public"
→ Invokes CrossRepoValidation workflow
→ Compares ~/.claude with ~/Projects/PAI
→ Reports private content in wrong place

Utility

Example 7: Recall Past Work

User: "We just worked on the status line - why broken again?"
→ Invokes WorkContextRecall workflow
→ Searches MEMORY/, git history for "status line"
→ Presents timeline of changes and possible regression

Quick Reference

The Four Core Operations

Operation	Input	Output	Duration
IntegrityCheck	Codebase scan	List of broken refs found/fixed	~2-5 min
DocumentSession	Session transcript	PAISYSTEMUPDATES entry	~30s
DocumentRecent	Git history since last update	Multiple PAISYSTEMUPDATES entries	~1-2 min
GitPush	PAISYSTEMUPDATES directory	git commit + push	~10s

Composition Patterns

End of Session:     DocumentSession → GitPush
After Refactoring:  IntegrityCheck → DocumentSession → GitPush
Catch-up:           DocumentRecent → GitPush
Quick Push:         GitPush (if docs already created)

Security Audits

Audit Type	Tool	Scope	Duration
Secret Scan	TruffleHog	Any directory	~30s-2min
Cross-Repo	Diff agents	Both repos	~1 min
Privacy Check	grep/patterns	skills/ (excl USER/WORK)	~30s

Documentation Format

Verbose Narrative Structure:

The Story (1-3 paragraphs): Background, Problem, Resolution
How It Used To Work: Previous state with bullet points
How It Works Now: New state with improvements
Going Forward: Future implications
Verification: How we know it works

When to Use

Integrity Checks

After major refactoring
Before releasing updates
Periodic system health checks
When something "feels broken"
Before pushing to public PAI repo

Documentation

End of significant work sessions
After creating new skills/workflows/tools
When architectural decisions are made
To maintain system history

Security Scanning

Before any git commit to public repos
When auditing for credential leaks
Periodic security hygiene checks
After receiving external code/content

Privacy Validation

After working with USER/ or WORK/ content
Before any public commits
When creating new skills that might reference personal data
Periodic audit to ensure data isolation

Work Context Recall

When Daniel asks about past work ("we just fixed that")
Questions about why decisions were made
Finding artifacts from previous sessions
Debugging something that was "already fixed"
Resuming multi-session projects

Tools

Tool	Purpose	Location
SecretScan.ts	TruffleHog wrapper for credential detection	`CORE/Tools/SecretScan.ts`
CreateUpdate.ts	Create new system update entries	`Tools/CreateUpdate.ts`
UpdateIndex.ts	Regenerate index.json and CHANGELOG.md	`Tools/UpdateIndex.ts`
UpdateSearch.ts	Search and query system updates	`Tools/UpdateSearch.ts`
ExtractArchitectureUpdates.ts	Historical migration tool (one-time use)	`Tools/ExtractArchitectureUpdates.ts`

Templates

Template	Purpose	Location
Update.md	Template for system update entries	`Templates/Update.md`

Output Locations

Output	Location
Integrity Reports	`MEMORY/STATE/integrity/YYYY-MM-DD.md`
System Updates	`MEMORY/PAISYSTEMUPDATES/YYYY/MM/*.md`
Update Index	`MEMORY/PAISYSTEMUPDATES/index.json`
Changelog	`MEMORY/PAISYSTEMUPDATES/CHANGELOG.md`

Related Skills

PAI - Public PAI repository management (includes PAIIntegrityCheck)
CORE - System architecture and memory documentation
Evals - Regression testing and capability verification