Contributing
We welcome contributions from the community.
How to Contribute
Playbooks
Playbooks are directories containing a SKILL.md file with YAML frontmatter:
code
---
name: vuln-xss
description: "XSS testing — injection point discovery, payload crafting, WAF bypass"
---
Create a new directory under GiScan/playbooks/ with a descriptive name, then add a SKILL.md containing phase-based execution steps.
Intelligence Layers
Add or update data layers in the GiScan/intelligence/ directory. The format is JSON with predefined structure.
Tools
Add new tools to GiScan/scripts/tools-catalog.json.
Pull Request Process
- Fork the repository
- Create a branch:
git checkout -b feature/your-feature - Commit and push your changes
- Open a Pull Request against the
mainbranch - Wait for maintainer review
Guidelines
- Follow the existing playbook format (YAML frontmatter + phase-based execution)
- Include documentation for new features
- Test your playbook before submitting
- Adhere to the Code of Conduct