pentest-lyan — Claude Code skill: what it does, how to install
pentest-lyan-web-security-testing is a Claude Code skill for web penetration testing: it models threats, reads frontend JavaScript and checks whether one role can reach past another.
no license 166 installs ★ 13 updated 2026-10-09
npx skills add reason-machines/security-skills --skill pentest-lyan-web-security-testing -a claude-codeWhat pentest-lyan-web-security-testing does
The run goes in three stages: discovery, attack, audit. Discovery means reading the frontend JavaScript to work out request signing, parameters and business rules before anything is sent at the API. Threats come from 12 angles, among them authentication, access control, input handling, file uploads and third-party dependencies.
A finding only counts once the effect on data is confirmed — a record really changed, a state really moved. You declare each account's role_level (high_privilege, standard, limited) yourself; the skill builds a permission matrix from those and tests crossings. Progress is kept in pentest-data/<project-id>/, so --resume picks up an interrupted run and --list shows what is already there.
Python 3.8+ with the project dependencies is the baseline. Playwright MCP adds browser automation and session pooling; without it the skill falls back to curl. Credentials sit in plaintext under pentest-data/, so that folder belongs in .gitignore before the first run. Reports come out twice: Markdown for technical detail, Word for handover.
What it helps with
- run a web pentest without keeping a manual checklist
- catch privilege escalation between an admin and a regular user
- prove a bug changes stored data instead of only returning HTTP 200
- resume an interrupted run from the saved state
- hand a Word report to the client and Markdown notes to the team
Example prompts for the agent
- Run pentest-lyan against my staging build and show me where access breaks between roles.
- Pick up the last pentest-lyan run with
--resume <project-id>. - Start pentest-lyan with two logins:
adminatrole_level: high_privilegeanduser1atrole_level: standard.
How to install pentest-lyan-web-security-testing
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill pentest-lyan-web-security-testing -a claude-code2Manually: put the files in place
~/.claude/skills/pentest-lyan-web-security-testing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pentest-lyan-web-security-testing/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill pentest-lyan-web-security-testing -a codex2Manually: put the files in place
.agents/skills/pentest-lyan-web-security-testing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill pentest-lyan-web-security-testing -a cursor2Manually: put the files in place
.cursor/skills/pentest-lyan-web-security-testing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/security-skills skills/pentest-lyan-web-security-testing2Manually: put the files in place
.github/skills/pentest-lyan-web-security-testing/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill pentest-lyan-web-security-testing -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/security-skills --path skills/pentest-lyan-web-security-testingManually: put the files in place
.devin/skills/pentest-lyan-web-security-testing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill pentest-lyan-web-security-testing -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pentest-lyan-web-security-testing
How do I install pentest-lyan in Claude Code?
Run npx skills add reason-machines/security-skills --skill pentest-lyan-web-security-testing -a claude-code. The skill then sits at ~/.claude/skills/pentest-lyan-web-security-testing/SKILL.md.
What does pentest-lyan do?
It drives an autonomous web app assessment through three stages, reads frontend code before hitting the API, and confirms findings by the change they cause in data. You get both a Markdown and a Word report.
How many accounts does the test need?
Two or more for full cross-role checks. With one account or none the skill runs in a reduced mode and, if it finds a signup page, asks you to create more. Role level is always stated by the user.