JQ AI Skills

Reusable AI skills by JQ AI SYSTEMS.

These skills are small, portable instruction folders for Claude/Codex-style workflows. They are published under the MIT License so you can adapt them for your own local setup.

Start Here

New here? Pick one route:

Need the compact command map? Use QUICK_REFERENCE.md. Want the full catalog? Use docs/catalog.md.

Preview

Launch Video

Watch the 30-second launch video with music.

The launch video is a promotional preview of the public skill library. Skill installation does not require these media assets.

Quick Start

If you are new here, start with one skill rather than installing everything:

For first-use help, use START_HERE.md, QUICK_REFERENCE.md, or the route picker in docs/examples/visitor-paths.md. For install details, use INSTALL.md, docs/guides/one-minute-install.md, and docs/guides/install-verification.md.

Install flow:

1. Pick a skill folder from skills/.
2. Copy the whole folder into your local skills directory, or use the install scripts below.
3. Restart or reload your AI coding tool.
4. Invoke the skill by name in your prompt.

Example prompts:

Use $github-safe-publisher to prepare this repo for a public release.
Use $case-study-writer to turn this private project summary into a public-safe case study.
Use $outreach-pipeline-designer to design a safe human-reviewed prospecting workflow.
Use $cold-outreach-writer to draft a cold email for this prospect from my research notes.
Use $lead-scorer to score this lead list against my rubric and rank it.
Use $etsy-listing-optimizer to audit and rewrite a marketplace listing safely.
Use $research-brief-curator to turn public links into a safe weekly research brief.
Use $verify-public-claims to check this public copy against the supplied evidence and flag unsupported claims.
Use $research-to-article to turn these sources into a traceable, publication-ready article package.
Use $write-evidence-backed-profile to draft this profile copy from the approved evidence pack.
Use $release-announcement-writer to turn this changelog into release notes and a launch post.
Use $github-profile-proof-updater to refresh my GitHub profile assets and prepare the proof trail.
Use $social-campaign-proof-tracker to turn this project update into LinkedIn/X copy, alt text, and follow-up notes.
Use $skill-reviewer to audit this downloaded skill before installing it.
Use $em-dash-remover to clean this landing page copy.
Use $code-deduplicator to consolidate repeated formatting helpers in this sample.
Use $brand-voice-linter to check this copy against our voice guide.
Use $php-form-mailer to make this contact form send email without a third-party service.
Use $client-intake-builder to create a branded intake questionnaire for this project.
Use $llms-txt-generator to create an llms.txt for this site.
Use $vault-janitor to scan this folder and report what is safe to clean.
Use $obsidian-daily-note to log this to today's daily note.
Use $idea-inbox to capture this idea into my ideas folder.
Use $demo-animation-v2 to create a responsive animated walkthrough.
Use $proposal-writer to draft a proposal for this client from my pricing config and their brief.
Use $follow-up-radar to scan my outreach folder and show me what follow-ups are overdue.
Use $client-workspace-scaffolder to set up a folder for my new client.
Use $discovery-brief to run discovery for this client project.
Use $implement-client-feedback to turn these revision notes into scoped changes and verify every item.
Use $client-delivery-auditor to audit this final package and draft a clear handoff.
Use $website-change-verifier to verify this website change across routes, rendering, metadata, and discovery surfaces.
Use $skill-builder to turn the workflow we just did into a reusable skill.
Use $session-handoff to wrap up this session into a START_HERE.md.
Use $agents-md-writer to register my local skills for both Claude Code and Codex.
Use $ops-status-report to generate this week's status snapshot of my workspace.
Use $screen-recorder to record a region of my screen.
Use $remove-ai-image-metadata to inspect these images, create verified clean copies, and report which explicit AI provenance metadata was removed.

Example Artifacts

Every skill ships with public-safe proof: fake-data samples, guides, and checklists a visitor can inspect before installing anything. The short list below covers the main entry points; everything else is one click away.

• docs/examples/README.md is the full index of public-safe samples, walkthroughs, workflow bundles, and first-run outputs.
• docs/examples/public-proof-index.md gathers the install, safety, sample, system, and visual proof assets in one place.
• docs/catalog.md is the complete catalog of all installable skills, recommended bundles, and safe install defaults.
• docs/skill-quality-matrix.md compares skill maturity, visible proof, safety sensitivity, and safest install notes.
• INSTALL.md, TROUBLESHOOTING.md, and the guides in docs/guides/ cover install, verification, update, review, and first-skill selection routines.
• CHANGELOG.md, RELEASE_CHECKLIST.md, SECURITY.md, ROADMAP.md, and SUPPORT.md document how this repo is maintained and released.

Skill Folder Structure

Each skill is packaged as a self-contained folder:

skill-name/
  SKILL.md
  agents/
    openai.yaml
  assets/       optional templates, images, or reusable files
  references/   optional supporting docs
  scripts/      optional helper scripts

For a field-by-field walkthrough, use docs/guides/skill-anatomy.md. To create a new skill, copy skills/_template/ and replace the placeholder names, descriptions, and prompts.

Skills Included

Safety & Publishing

Public Proof

Growth & Outreach

Client Work

Content & Research

Dev Workflow

Media & Provenance

Notes & Productivity

Agent Workflow

Demo & Presentation

Which Skill Should I Use?

For the fastest guided install, see docs/guides/one-minute-install.md. To score the safest first install, see docs/guides/first-skill-scorecard.md. To prove the full first-install path, see docs/examples/first-install-proof.md. To run the selected skill with fake input, see docs/examples/first-skill-walkthrough.md, the first-skill candidate pack, and its expected review. For the detailed visitor guide, see docs/guides/skill-selection.md. To understand the folder contract, see docs/guides/skill-anatomy.md. To review an unfamiliar skill before install, see docs/guides/skill-review-checklist.md. For the complete catalog, see docs/catalog.md.

Why This Matters

The skills repo is the technical credibility layer behind the client-facing systems. It shows how JQ AI SYSTEMS packages repeatable AI workflows into reusable instructions, review steps, and safety checks instead of relying on one-off prompts.

Installation

For the short command reference, see INSTALL.md. After installing, confirm the setup with docs/guides/install-verification.md. If a skill does not show up after install, see TROUBLESHOOTING.md.

For Claude Code/Codex-style local skills:

1. Create a local skills folder if you do not already have one.
2. Copy the selected skill folder from skills/.
3. Place the whole folder in your local skills directory.
4. Restart or reload your AI coding tool if needed.
5. Ask the tool to use the skill by name.

Only install skills you understand. Review the instructions before using them on private projects.

Codex Install

Copy a whole skill folder into your Codex skills directory, then restart Codex so the skill list reloads.

Fast install from this repo:

Windows PowerShell:

.\install.ps1 github-safe-publisher
.\install.ps1 case-study-writer
.\install.ps1 outreach-pipeline-designer
.\install.ps1 etsy-listing-optimizer
.\install.ps1 research-brief-curator
.\install.ps1 -All

macOS/Linux:

chmod +x ./install.sh
./install.sh github-safe-publisher
./install.sh case-study-writer
./install.sh outreach-pipeline-designer
./install.sh etsy-listing-optimizer
./install.sh research-brief-curator
./install.sh --all

List available skills:

.\install.ps1 -List

./install.sh --list

Manual install:

Windows PowerShell:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills" | Out-Null
Copy-Item -Recurse -Force ".\skills\web-scraper" "$env:USERPROFILE\.codex\skills\web-scraper"

macOS/Linux:

mkdir -p ~/.codex/skills
cp -R ./skills/web-scraper ~/.codex/skills/web-scraper

Then invoke it by name:

Use $web-scraper to build a browser console scraper for this public paginated website.

Contributing

Use CONTRIBUTING.md for the expected folder format, metadata requirements, safety rules, and pre-submission checklist. For a public-safe proposal shape, use docs/examples/skill-request-example.md.

Safety Notes

• These files are instructions, not secrets.
• Do not paste sensitive keys, sign-in material, customer records, account exports, or unreleased project notes into prompts unless you fully understand where they will go.
• Use SECURITY.md for responsible-use rules and sensitive issue reporting.
• The skill-reviewer skill exists to help inspect third-party skill files before installing them.
• Use docs/guides/skill-review-checklist.md before installing unfamiliar or modified skill folders.
• Run new skills on a test folder before using them in production work.

License

Released under the MIT License.

More systems and case studies: ai.joaoqueiros.com/systems

Want a custom workflow built around your team? Start here: ai.joaoqueiros.com/contact