Security Principles
Critique principles for secure code development
- Type
- Subagent
- Repository
- nyldn/claude-octopus
- GitHub stars
- 4.1k
- License
- MIT
- Repo last updated
- Sep 26, 2026
- Source file
- agents/principles/security.md
What Security Principles is
Security Principles is a subagent published in the nyldn/claude-octopus repository on GitHub, which has about 4.1k stars. The repository describes itself as: “Run multiple AI models against the same research, design, or coding task. Surface disagreements before you ship.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Security Principles and get back a compact result.
How to install Security Principles
Claude Code
- Download security.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from agents/principles/security.md, shared under the repository's MIT license. Read the full file on GitHub.
Code MUST adhere to these security requirements:
Input & Output
- No SQL Injection - All database queries MUST be parameterized. Never concatenate user input into SQL strings.
- No XSS (Cross-Site Scripting) - All output MUST be properly escaped/encoded for the context (HTML, JavaScript, URL, CSS).
- No Command Injection - Never pass user input directly to shell commands. Use safe APIs or strict validation.
Authentication & Authorization
- No CSRF - State-changing requests MUST require valid CSRF tokens.
- Secure Authentication - Use strong password hashing (bcrypt/argon2), implement rate limiting, support MFA.
- Least Privilege - Grant minimal permissions required. Never run as root/admin unless necessary.
Data Protection
- Secure Defaults - Fail closed, not open. Default to denying access.
- Sensitive Data Handling - Never log passwords, tokens, or PII. Use encryption at rest and in transit.
- Secure Session Management - Use secure, httpOnly cookies. Regenerate session IDs on privilege changes.
Defense in Depth
- Input Validation - Validate ALL user input server-side. Client-side validation is for UX only.
- Error Handling - Never expose stack traces or internal details to users.
- Dependency Security - Audit dependencies for known vulnerabilities. Keep packages updated.
Checklist
When reviewing code, verify:
- No hardcoded secrets or credentials
- All inputs validated and sanitized
- All outputs properly encoded
- Authentication properly implemented
- Authorization checks on all protected resources
- Secure communication (HTTPS, TLS)
- Proper error handling without info leakage
- Logging without sensitive data exposure
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Security Principles?
Security Principles is a subagent for Claude Code and Claude Cowork from the nyldn/claude-octopus repository on GitHub. Critique principles for secure code development
How do I install Security Principles in Claude Code?
Download security.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Security Principles in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Security Principles safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Octopus Code Review Expert code review skill leveraging the code-reviewer persona. Use when you need comprehensive code quality assessment, security vulnerability detection, or architecture review. Subagent · nyldn/claude-octopus
- Octo Multi-tentacled orchestrator using Double Diamond methodology. v11.9.2. 31 expert personas, 54 commands, 63 skills. Commands '/octo:*'. Run /octo:setup for guided setup. Compatible with Claude Code and Factory AI Droid. Plugin · nyldn/claude-octopus
- Performance Principles Critique principles for high-performance code Subagent · nyldn/claude-octopus
- Product Writer Expert product writer specializing in AI-optimized PRDs, user stories, and acceptance criteria. Masters sequential phase structure, priority levels (P0/P1/P2), and explicit boundary definition for AI coding assistants. Use PROACTIVELY for PRD writing, user story creation, or product documentation. Subagent · nyldn/claude-octopus
- Strategy Analyst Expert strategy analyst specializing in market analysis, competitive intelligence, business case development, and strategic recommendations. Masters frameworks like Porter's Five Forces, SWOT, and business model canvas. Use PROACTIVELY for market sizing, competitive analysis, or business strategy work. Subagent · nyldn/claude-octopus
- Security Auditor Security auditor. Delegate only when the user explicitly starts an Octopus workflow. Subagent · nyldn/claude-octopus
- Tdd Orchestrator Octopus-only TDD orchestrator. Use only when the user explicitly selects this agent or starts an Octopus workflow; never for an ordinary request. Subagent · nyldn/claude-octopus
- Research Synthesizer Expert research synthesizer specializing in literature review, multi-source synthesis, thematic analysis, and research gap identification. Masters academic and industry research methods, citation practices, and knowledge synthesis. Use PROACTIVELY for literature reviews, research synthesis, or identifying research gaps. Subagent · nyldn/claude-octopus