Skip to content

    Type a page, a command such as keryn scan, or a rule id.

    Agent skill and instruction files

    View as Markdown

    Treat the files a coding agent reads at the start of a session as what they are: code that instructs a model. Find the ones that hide instructions from a human reviewer, pipe a remote script into a shell, or pre-approve a shell for any command.

    This page is about screening those files in your repository. The skills Keryn itself ships for Claude Code and Codex are a different thing: see Keryn Skills.

    Agent Files
    Agent Skills (Claude, Codex and others) SKILL.md
    Claude Code CLAUDE.md
    Codex and other AGENTS.md readers AGENTS.md
    Gemini CLI GEMINI.md
    Cursor .cursorrules, .cursor/rules/*.md, .cursor/rules/*.mdc
    Windsurf .windsurfrules
    Cline .clinerules
    GitHub Copilot .github/copilot-instructions.md
    • Hidden or poisoned instructions (mcp:skill:poisoned, mcp:skill:suspicious): hidden Unicode, instructions to conceal something from the user, exfiltration URLs, reads of secrets, and prompt injection, in the name, description or body. Telling the model what to do is not a finding on its own; that is what these files are for.
    • A remote script piped into a shell (mcp:skill:remote-exec): curl … | sh, bash <(curl …), iex (irm …), which run whatever that URL serves at the time.
    • An unscoped shell pre-approved (mcp:skill:unrestricted-tools): allowed-tools grants Bash, Bash(*) or *, so the file’s commands run without the user being asked.

    A finding the pattern rules already report is folded into one. The screen runs offline with every scan and has no flag to turn it off.

    No inline suppression comment applies to these files. Fix the file, or record a decision as described in suppressions.

    • Only the file names above. An instruction file with another name, or instructions loaded from elsewhere at run time, is not screened by this pass (the pattern rules may still match it).
    • The screen reads the text. It does not run the agent or observe what it does; for that, see test AI security boundaries.