Back to search
agent-skills
SkillGitHub
112 reusable Agent Skills for AI coding assistants. Each skill provides specialized knowledge and workflows that extend agent capabilities.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/jwynia-agent-skills)HTML
<a href="/listings/jwynia-agent-skills"><img src="/api/listings/jwynia-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Use `npx skills add` to install skills:
Browse by Category
Skills are organized into three top-level categories for easy filtering:
# Creative/narrative skills (~57 skills) npx skills add https://github.com/jwynia/agent-skills/tree/main/skills/creative # Technical/development skills (~26 skills) npx skills add https://github.com/jwynia/agent-skills/tree/main/skills/tech # General utilities (~29 skills) npx skills add https://github.com/jwynia/agent-skills/tree/main/skills/general
Install a Single Skill
npx skills add https://github.com/jwynia/agent-skills/tree/main/skills/general/meta/skill-builder
Browse All Skills
npx skills add https://github.com/jwynia/agent-skills/tree/main/skills
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 283 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Agent Skills Collection
- **112 reusable [Agent Skills](https://agentskills.io)** for AI coding assistants. Each skill provides specialized knowledge and workflows that extend agent capabilities.
- ## Installing Skills
- Use `npx skills add` to install skills:
- ### Browse by Category
- Skills are organized into three top-level categories for easy filtering:
- ```bash
- # Creative/narrative skills (~57 skills)
- npx skills add https://github.com/jwynia/agent-skills/tree/main/skills/creative
- # Technical/development skills (~26 skills)
- npx skills add https://github.com/jwynia/agent-skills/tree/main/skills/tech
- # General utilities (~29 skills)
- npx skills add https://github.com/jwynia/agent-skills/tree/main/skills/general
- ```
- ### Install a Single Skill
- ```bash
- npx skills add https://github.com/jwynia/agent-skills/tree/main/skills/general/meta/skill-builder
- ```
- ### Browse All Skills
- ```bash
- npx skills add https://github.com/jwynia/agent-skills/tree/main/skills
- ```
- ## Available Skills (112 total)
- ### Creative (57 skills)
- Story/narrative focused skills for fiction writing, worldbuilding, and creative work.
- #### Fiction - Core & Craft (10)
- Core diagnostics, writing partnerships, and sentence-level craft:
- - **story-sense** - Diagnose what any story needs regardless of current state
- - **story-coach** - Assistive writing guidance (guides but never writes)
- - **story-collaborator** - Active writing partnership (contributes prose alongside writer)
- - **story-analysis** - Systematically evaluate completed stories or chapters
- - **story-idea-generator** - Genre-first story concept generation
- - **prose-style** - Sentence-level craft diagnostics
- - **revision** - Edit pass guidance when revision feels overwhelming
- - **drafting** - First draft execution and block-breaking
- - **cliche-transcendence** - Transform predictable story elements into fresh versions
- - **genre-conventions** - Genre diagnostics and genre-specific element generation
- #### Fiction - Character (6)
- Character development, dialogue, and distinctive character creation:
- - **character-arc** - Character transformation arc design and troubleshooting
- - **character-naming** - Break LLM name defaults with external entropy
- - **dialogue** - Dialogue diagnostics for flat or same-voice characters
- - **memetic-depth** - Create perception of cultural depth through juxtaposition
- - **statistical-distance** - Transform clichéd elements by pushing toward statistical edges
- - **underdog-unit** - Stories about institutional outcasts given impossible mandates
- #### Fiction - Structure (12)
- Pacing, scene structure, outlines, and multi-level story management:
- - **scene-sequencing** - Pacing and scene-sequel rhythm
- - **endings** - Resolution diagnostics for weak or rushed endings
- - **key-moments** - Structure stories around essential emotional moments
- - **story-zoom** - Multi-level story synchronization across abstraction levels
- - **outline-coach** - Assistive outline coaching through questions
- - **outline-collaborator** - Active outline partnership
- - **reverse-outliner** - Reverse-engineer published books into structured outlines
- - **novel-revision** - Multi-level novel revision without cascade problems
- - **identity-denial** - Stories about protagonists refusing self-transformation
- - **moral-parallax** - Stories about systemic exploitation and moral distance
- - **perspectival-constellation** - Multi-POV stories through catalyst environments
- - **positional-revelation** - Stories about ordinary people becoming crucial through position
- #### Fiction - Worldbuilding (11)
- World-level systems, cultures, languages, and shared continuity:
- - **worldbuilding** - World-level story diagnostics
- - **systemic-worldbuilding** - Cascading consequences from speculative changes
- - **oblique-worldbuilding** - Worldbuilding quotes and epigraphs via documentary perspectives
- - **belief-systems** - Religious and belief system design
- - **economic-systems** - Currencies, trade networks, and resource economies
- - **governance-systems** - Political entities and governance structures
- - **settlement-design** - Cities, towns, and settlement design
- - **conlang** - Phonologically consistent constructed languages
- - **language-evolution** - Evolving language systems and linguistic history
- - **metabolic-cultures** - Cultures for closed-loop life support systems
- - **world-fates** - Long-term fate and fortune across shared worlds
- #### Fiction - Application (14)
- Specialized generators, adaptation tools, and applied storytelling:
- - **adaptation-synthesis** - Synthesize new works from extracted functional DNA
- - **dna-extraction** - Extract functional DNA from existing works (TV, film, books)
- - **media-adaptation** - Analyze existing media for transferable elements
- - **book-marketing** - Marketing copy diagnostics and platform-optimized blurbs
- - **chapter-drafter** - Autonomous chapter drafting with multi-skill editorial passes
- - **flash-fiction** - Flash fiction and micro fiction diagnostics
- - **interactive-fiction** - Branching narrative diagnostics
- - **game-facilitator** - Narrative RPG game master for collaborative storytelling
- - **table-tone** - Tonal delivery calibration for tabletop RPG sessions
- - **list-builder** - Comprehensive randomization lists for creative entropy
- - **multi-order-evolution** - Multi-generational societal evolution for sci-fi
- - **paradox-fables** - Fables embodying paradoxical wisdom
- - **sensitivity-check** - Representation evaluation and harm flagging
- - **shared-world** - Wiki-style world bible for collaborative fiction
- - **sleep-story** - Stories designed to help listeners fall asleep
- #### Humor (1)
- - **joke-engineering** - Humor diagnostics and improvement
- #### Music (2)
- - **lyric-diagnostic** - Song lyric analysis and improvement
- - **musical-dna** - Extract musical characteristics from artists
- ---
- ### Tech (26 skills)
- Technical and development focused skills.
- #### AI (1)
- - **mastra-hono** - Mastra AI framework with Hono integration
- #### Development (14)
- - **agile-coordinator** - Multi-agent task orchestration (git-only, platform-agnostic)
- - **agile-workflow** - Agile development workflow (git-only, platform-agnostic)
- - **architecture-decision** - ADR creation and trade-off analysis
- - **code-review** - Structured code review guidance
- - **devcontainer** - Development container configuration
- - **electron-best-practices** - Electron + React desktop app development best practices
- - **gitea-coordinator** - Multi-agent task orchestration for Gitea
- - **gitea-workflow** - Agile workflow for Gitea with tea CLI
- - **github-agile** - GitHub-driven agile workflows
- - **product-analysis** - Competitive product analysis and market evaluation
- - **requirements-analysis** - Requirements discovery and documentation
- - **system-design** - Software architecture and design
- - **task-decomposition** - Break down development tasks
- - **typescript-best-practices** - TypeScript patterns and practices
- #### Frontend (4)
- - **frontend-design** - UI/UX design patterns
- - **pwa-development** - PWA implementation (React/Svelte)
- - **react-pwa** - Progressive Web Apps with React
- - **shadcn-layouts** - Tailwind/shadcn layout patterns
- #### Game Development (3)
- - **abstract-strategy** - Board game design
- - **godot-asset-generator** - AI asset generation for Godot
- - **godot-best-practices** - Godot engine best practices
- #### Security (4)
- - **config-scan** - Configuration security scanning
- - **dependency-scan** - Dependency vulnerability scanning
- - **secrets-scan** - Secrets detection
- - **security-scan** - General security scanning
- ---
- ### General (29 skills)
- Universal utility skills for research, documents, and productivity.
- #### Analysis (1)
- - **technology-impact** - McLuhan's Tetrad analysis for technology impacts
- #### Communication (2)
- - **presentation-design** - Design effective presentations and slides
- - **speech-adaptation** - Transform written content for spoken delivery
- #### Document Processing (7)
- - **docx-generator** - Word document generation
- - **document-to-narration** - Convert documents to narrated video scripts with TTS audio
- - **ebook-analysis** - Parse ebooks and extract concepts
- - **pdf-generator** - PDF document generation
- - **pptx-generator** - PowerPoint presentation generation
- - **revealjs-presenter** - RevealJS presentation generation
- - **xlsx-generator** - Excel spreadsheet generation
- #### Education (2)
- - **competency** - Competency framework development
- - **gentle-teaching** - AI-assisted learning guidance
- #### Ideation (2)
- - **brainstorming** - Idea expansion and divergent thinking
- - **naming** - Brand, product, and character naming
- #### Meta (3)
- - **context-network** - Build and maintain context networks
- - **context-retrospective** - Analyze agent interactions for improvements
- - **skill-builder** - Create new agent skills
- #### Productivity (1)
- - **task-breakdown** - Neurodivergent-friendly task decomposition
- #### Research (7)
- - **claim-investigation** - Investigate social media claims
- - **fact-check** - Verify claims against sources
- - **media-meta-analysis** - Media analysis methodology
- - **research** - Research quality diagnostics
- - **research-workflow** - Structured research methodology
- - **web-search** - Built-in web search (no API key required)
- - **web-search-tavily** - Advanced Tavily search with filtering and scoring
- #### Writing (4)
- - **blind-spot-detective** - Identify gaps in non-fiction writing
- - **non-fiction-revision** - Non-fiction book revision
- - **summarization** - Effective summarization techniques
- - **voice-analysis** - Extract and document writing voice
- ## Project Structure
- ```
- skills/ # 112 skills in main tree
- ├── creative/ # 57 skills - Story/narrative focus
- │ ├── fiction/ # 54 skills
- │ │ ├── application/
- │ │ ├── character/
- │ │ ├── core/
- │ │ ├── craft/
- │ │ ├── orchestrators/
- │ │ ├── structure/
- │ │ └── worldbuilding/
- │ ├── humor/
- │ └── music/
- │
- ├── tech/ # 25 skills - Technical/development
- │ ├── ai/
- │ ├── development/
- │ │ ├── architecture/
- │ │ ├── quality/
- │ │ ├── tooling/
- │ │ └── workflow/
- │ ├── frontend/
- │ │ ├── design/
- │ │ └── pwa/
- │ ├── game-development/
- │ │ ├── design/
- │ │ └── godot/
- │ └── security/
- │
- ├── general/ # 28 skills - Universal utilities
- │ ├── analysis/
- │ ├── communication/
- │ ├── document-processing/
- │ │ ├── analysis/
- │ │ ├── pdf/
- │ │ ├── presentation/
- │ │ ├── spreadsheet/
- │ │ └── word/
- │ ├── education/
- │ ├── ideation/
- │ ├── meta/
- │ ├── productivity/
- │ ├── research/
- │ │ ├── methodology/
- │ │ ├── tools/
- │ │ └── verification/
- │ └── writing/
- │ ├── analysis/
- │ └── revision/
- │
- ├── development/ # 1 skill - Standalone development
- │ └── architecture/
- │
- └── education/ # 1 skill - Standalone education
- reference/ # agentskills.io spec and validation tools
- context-network/ # Planning and coordination docs
- ```
- ## Contributing
- See `context-network/processes/creation.md` for the skill creation workflow.
- Quick start:
- 1. Plan in `context-network/elements/skills/`
- 2. Create skill in `skills/[creative|tech|general]/[domain]/[skill-name]/`
- 3. Validate with `skills-ref validate ./skills/path/to/skill`
- ## References
- - [Agent Skills Specification](https://agentskills.io)
- - [skills-ref Validation Tool](reference/agentskills/skills-ref/)
skills/tech/development/tooling/devcontainer/scripts/scan-image.ts · Bundled script · 342 lines · 2 findings marked
- #!/usr/bin/env -S deno run --allow-run --allow-net
- /**
- * Container Image Security Scanner
- *
- * Wraps Trivy for vulnerability scanning of container images.
- * Provides human-readable output with remediation suggestions.
- *
- * Usage:
- * deno run --allow-run --allow-net scripts/scan-image.ts <image-name>
- *
- * Examples:
- * deno run --allow-run --allow-net scripts/scan-image.ts node:20-slim
- * deno run --allow-run --allow-net scripts/scan-image.ts mcr.microsoft.com/devcontainers/base:ubuntu
- *
- * Requires Trivy to be installed:
- * brew install trivy
- * # or
- * curl -sfL https://raw.githubusercontent.com/aquasecurity/trivy/main/contrib/install.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 19 on GitHub
- */
- interface Vulnerability {
- VulnerabilityID: string;
- PkgName: string;
- InstalledVersion: string;
- FixedVersion?: string;
- Severity: string;
- Title?: string;
- Description?: string;
- PrimaryURL?: string;
- }
- interface ScanResult {
- Target: string;
- Type: string;
- Vulnerabilities?: Vulnerability[];
- }
- interface TrivyOutput {
- Results?: ScanResult[];
- }
- const SEVERITY_ORDER = ["CRITICAL", "HIGH", "MEDIUM", "LOW", "UNKNOWN"];
- const SEVERITY_EMOJI: Record<string, string> = {
- CRITICAL: "🔴",
- HIGH: "🟠",
- MEDIUM: "🟡",
- LOW: "🔵",
- UNKNOWN: "⚪",
- };
- async function checkTrivyInstalled(): Promise<boolean> {
- try {
- const command = new Deno.Command("trivy", {
- args: ["--version"],
- stdout: "null",
- stderr: "null",
- });
- const { code } = await command.output();
- return code === 0;
- } catch {
- return false;
- }
- }
- async function scanImage(imageName: string): Promise<TrivyOutput | null> {
- console.log(`\n🔍 Scanning image: ${imageName}\n`);
- console.log("This may take a moment for first scan (downloading vulnerability database)...\n");
- try {
- const command = new Deno.Command("trivy", {
- args: [
- "image",
- "--format", "json",
- "--severity", "CRITICAL,HIGH,MEDIUM,LOW",
- imageName,
- ],
- stdout: "piped",
- stderr: "piped",
- });
- const { code, stdout, stderr } = await command.output();
- if (code !== 0) {
- const errorText = new TextDecoder().decode(stderr);
- console.error(`❌ Trivy scan failed:\n${errorText}`);
- return null;
- }
- const outputText = new TextDecoder().decode(stdout);
- return JSON.parse(outputText);
- } catch (error) {
- console.error(`❌ Error running Trivy: ${error}`);
- return null;
- }
- }
- function summarizeVulnerabilities(results: ScanResult[]): Map<string, Vulnerability[]> {
- const bySeverity = new Map<string, Vulnerability[]>();
- for (const severity of SEVERITY_ORDER) {
- bySeverity.set(severity, []);
- }
- for (const result of results) {
- if (!result.Vulnerabilities) continue;
- for (const vuln of result.Vulnerabilities) {
- const list = bySeverity.get(vuln.Severity) || [];
- list.push(vuln);
- bySeverity.set(vuln.Severity, list);
- }
- }
- return bySeverity;
- }
- function printSummary(bySeverity: Map<string, Vulnerability[]>): void {
- console.log("─".repeat(60));
- console.log("\n📊 VULNERABILITY SUMMARY\n");
- let total = 0;
- let fixable = 0;
- for (const severity of SEVERITY_ORDER) {
- const vulns = bySeverity.get(severity) || [];
- if (vulns.length === 0) continue;
- const fixableCount = vulns.filter(v => v.FixedVersion).length;
- total += vulns.length;
- fixable += fixableCount;
- console.log(
- `${SEVERITY_EMOJI[severity]} ${severity.padEnd(10)} ${vulns.length.toString().padStart(4)} vulnerabilities (${fixableCount} fixable)`
- );
- }
- console.log("─".repeat(40));
- console.log(` TOTAL: ${total} vulnerabilities`);
- console.log(` FIXABLE: ${fixable} have patches available`);
- }
- function printDetails(bySeverity: Map<string, Vulnerability[]>, showAll: boolean): void {
- console.log("\n📋 VULNERABILITY DETAILS\n");
- // Show CRITICAL and HIGH by default, all if requested
- const severitiesToShow = showAll
- ? SEVERITY_ORDER
- : ["CRITICAL", "HIGH"];
- for (const severity of severitiesToShow) {
- const vulns = bySeverity.get(severity) || [];
- if (vulns.length === 0) continue;
- console.log(`\n${SEVERITY_EMOJI[severity]} ${severity} (${vulns.length})\n`);
- console.log("─".repeat(60));
- // Group by package
- const byPackage = new Map<string, Vulnerability[]>();
- for (const vuln of vulns) {
- const list = byPackage.get(vuln.PkgName) || [];
- list.push(vuln);
- byPackage.set(vuln.PkgName, list);
- }
- for (const [pkg, pkgVulns] of byPackage) {
- const firstVuln = pkgVulns[0];
- console.log(`\n 📦 ${pkg} (${firstVuln.InstalledVersion})`);
- if (firstVuln.FixedVersion) {
- console.log(` 💡 Fix: Upgrade to ${firstVuln.FixedVersion}`);
- }
- for (const vuln of pkgVulns.slice(0, 3)) { // Show max 3 per package
- console.log(` • ${vuln.VulnerabilityID}`);
- if (vuln.Title) {
- const title = vuln.Title.length > 60
- ? vuln.Title.substring(0, 60) + "..."
- : vuln.Title;
- console.log(` ${title}`);
- }
- }
- if (pkgVulns.length > 3) {
- console.log(` ... and ${pkgVulns.length - 3} more`);
- }
- }
- }
- if (!showAll) {
- const mediumLow = (bySeverity.get("MEDIUM")?.length || 0) +
- (bySeverity.get("LOW")?.length || 0);
- if (mediumLow > 0) {
- console.log(`\n📝 ${mediumLow} MEDIUM/LOW vulnerabilities not shown. Use --all to see all.`);
- }
- }
- }
- function printRecommendations(bySeverity: Map<string, Vulnerability[]>): void {
- console.log("\n💡 RECOMMENDATIONS\n");
- console.log("─".repeat(60));
- const critical = bySeverity.get("CRITICAL") || [];
- const high = bySeverity.get("HIGH") || [];
- if (critical.length > 0) {
- console.log("\n🔴 CRITICAL ISSUES - Address immediately:\n");
- // Find packages with critical vulns that have fixes
- const fixableCritical = critical.filter(v => v.FixedVersion);
- const uniquePackages = [...new Set(fixableCritical.map(v => v.PkgName))];
- if (uniquePackages.length > 0) {
- console.log(" Update these packages:");
- for (const pkg of uniquePackages.slice(0, 5)) {
- const vuln = fixableCritical.find(v => v.PkgName === pkg);
- if (vuln) {
- console.log(` • ${pkg}: ${vuln.InstalledVersion} → ${vuln.FixedVersion}`);
- }
- }
- if (uniquePackages.length > 5) {
- console.log(` ... and ${uniquePackages.length - 5} more`);
- }
- }
- const unfixableCritical = critical.filter(v => !v.FixedVersion);
- if (unfixableCritical.length > 0) {
- console.log(`\n ⚠️ ${unfixableCritical.length} critical vulnerabilities have no fix yet.`);
- console.log(" Consider using a different base image or monitoring for patches.");
- }
- }
- if (high.length > 0 && critical.length === 0) {
- console.log("\n🟠 HIGH PRIORITY - Plan to address soon:\n");
- const fixableHigh = high.filter(v => v.FixedVersion);
- console.log(` ${fixableHigh.length} of ${high.length} have available fixes.`);
- }
- // General recommendations
- console.log("\n📝 GENERAL RECOMMENDATIONS:\n");
- console.log(" 1. Update base image regularly");
- console.log(" Use specific version tags and update periodically");
- console.log("");
- console.log(" 2. Use minimal base images");
- console.log(" Consider: -slim, -alpine, or distroless variants");
- console.log("");
- console.log(" 3. Multi-stage builds");
- console.log(" Don't include build tools in final image");
- console.log("");
- console.log(" 4. Regular scanning");
- console.log(" Integrate trivy into CI/CD pipeline");
- }
- async function main() {
- const args = Deno.args;
- const showAll = args.includes("--all");
- const imageName = args.filter(a => !a.startsWith("--"))[0];
- if (!imageName) {
- console.log(`
- 🔍 Container Image Security Scanner
- Usage:
- deno run --allow-run --allow-net scan-image.ts <image-name> [--all]
- Examples:
- scan-image.ts node:20-slim
- scan-image.ts mcr.microsoft.com/devcontainers/base:ubuntu
- scan-image.ts my-app:latest --all
- Options:
- --all Show all vulnerabilities (default shows only CRITICAL and HIGH)
- Requires Trivy: brew install trivy
- `);
- Deno.exit(1);
- }
- // Check if Trivy is installed
- const trivyInstalled = await checkTrivyInstalled();
- if (!trivyInstalled) {
- console.error(`
- ❌ Trivy not found
- Install Trivy to use this scanner:
- macOS: brew install trivy
- Linux: curl -sfL https://raw.githubusercontent.com/aquasecurity/trivy/main/contrib/install.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 289 on GitHub
- Docker: docker run aquasec/trivy image ${imageName}
- More info: https://github.com/aquasecurity/trivy
- `);
- Deno.exit(1);
- }
- // Run scan
- const output = await scanImage(imageName);
- if (!output) {
- Deno.exit(1);
- }
- if (!output.Results || output.Results.length === 0) {
- console.log("✅ No vulnerabilities found!");
- Deno.exit(0);
- }
- // Process results
- const bySeverity = summarizeVulnerabilities(output.Results);
- // Check if any vulnerabilities
- let totalVulns = 0;
- for (const vulns of bySeverity.values()) {
- totalVulns += vulns.length;
- }
- if (totalVulns === 0) {
- console.log("✅ No vulnerabilities found!");
- Deno.exit(0);
- }
- // Print results
- printSummary(bySeverity);
- printDetails(bySeverity, showAll);
- printRecommendations(bySeverity);
- // Exit code based on severity
- const critical = bySeverity.get("CRITICAL") || [];
- const high = bySeverity.get("HIGH") || [];
- if (critical.length > 0) {
- console.log("\n🔴 CRITICAL vulnerabilities found - exit code 2");
- Deno.exit(2);
- } else if (high.length > 0) {
- console.log("\n🟠 HIGH vulnerabilities found - exit code 1");
- Deno.exit(1);
- }
- console.log("\n✅ No CRITICAL or HIGH vulnerabilities");
- }
- main();
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.