Hammad Majid Skills

A repository of production-quality, reusable Agent Skills compatible with the open Agent Skills standard and npx skills add.

Project Purpose

This repository provides a set of highly optimized, modular instruction sets (Agent Skills) to extend the capabilities of AI coding agents (such as Claude Code, Cursor, Codex, and others). By codifying complex workflows, database optimizations, and style rules into standardized skills, developers can streamline agent tasks and reduce prompt context waste.

---

Skills Directory

1. fine-tune-d1

Maximize Cloudflare D1 database performance, throughput, and type safety when building serverless architectures with Drizzle ORM.

• Focuses on: Schema design, transaction batching, query performance, and global read replication.

2. sparse-security-audit

Perform an evidence-driven, high-confidence security audit of application codebases focusing strictly on directly exploitable and reproducible vulnerabilities.

• Focuses on: Authentication & authorization, data handling (injections), SSRF, and PoC verification.

3. ste-writing

Rewrite prose (documentation, READMEs, commit messages, PR descriptions) into ASD-STE100 Simplified Technical English (STE) to eliminate "AI slop" and improve clarity.

• Includes: An automated STE linter script (scripts/ste-lint.py).

4. app-device-mockups

Generate clean, Figma-style flat UI mockups inside realistic, current-generation device frames.

• Focuses on: Professional visual framing, soft lighting, and product-ready photography layouts.

5. spec-to-pr

Automate the workflow of branching, staging, committing, and opening a structured GitHub pull request linked to a parent spec issue and child tickets.

• Focuses on: Context retrieval, branch management, and automated PR creation.

6. legal-writing

Apply a precise legal prose style to contracts, agreements, policies, and resolutions to tighten operative language and eliminate legal slop.

• Includes: An automated legal linter script (scripts/legal-lint.py).

---

Installation

These skills can be installed globally or at the project level using the open skills package manager.

Installing a Single Skill

To install a specific skill, run:

npx skills add hammadmajid/skills --skill <skill-name>

For example, to install the ste-writing skill:

npx skills add hammadmajid/skills --skill ste-writing

Installing All Skills

To install all skills from this repository into your project or global environment:

npx skills add hammadmajid/skills

Updating Skills

To update your installed skills to their latest versions, run:

npx skills update

---

Contribution Guide

We welcome community contributions to improve existing skills or add new ones.

1. Format: Every skill must live under a kebab-case subdirectory in the skills/ folder (e.g., skills/my-new-skill/).
2. Required Files:
   • SKILL.md: Mandatory file containing YAML frontmatter (with name matching the directory name, and a clear description) and the markdown instruction set.
   • scripts/, references/, assets/: Optional directories for executable scripts, documentation, and static assets.
3. Validation: A local Node.js validator checks that all skills conform to the repository standard. Run it locally before pushing:

   node .github/workflows/validate.js

   Every push and pull request is automatically validated by GitHub Actions.

---

License

This repository is licensed under the MIT License. Individual skills may preserve additional credit and copyright notes within their respective subfolders.