Softaworks Agent Toolkit

repository·main·Indexed 24 days ago

https://github.com/softaworks/agent-toolkit

A collection of packaged instructions, scripts, and specialized skills designed to extend AI coding agents like Claude Code, Codex, Cursor, and AdaL. The toolkit provides a marketplace of skills, agents, and slash commands for development, documentation, planning, and professional workflows, including tools for C4 architecture, API handoff documentation, and agent instruction refactoring.

Tokens
288.8K
Snippets
584
Records
1.1K
Agent score
81%

What's inside softaworks-agent-toolkit

  1. Overview of Marp Official Themes

    main

    Marp includes three official themes in its core implementation. Choosing a theme depends on the intended use case and desired visual style:

    1. default: A simple, versatile, and clean theme using sans-serif fonts. Best for general business presentations.
    2. gaia: A modern, energetic, and colorful theme with vibrant accents and gradient backgrounds. Best for creative or design-focused showcases.
    3. uncover: A minimal, elegant theme using serif fonts and wide margins. Best for formal or academic presentations.
  2. Overview of the React TypeScript Development Skill

    main

    The react-dev skill is a comprehensive reference for building type-safe React applications using TypeScript. It covers modern React patterns (React 18-19), including Server Components, type-safe routing (TanStack Router and React Router v7), and advanced component patterns like generics and discriminated unions.

    Use this skill when you need to:

    • Build typed React components or generic components (Tables, Modals, etc.).
    • Type event handlers, forms, or custom hooks.
    • Implement React 19 features like useActionState, use(), or Server Components.
    • Integrate type-safe routing.
    • Migrate existing codebases to React 19.

    Trigger phrases for the agent:

    • "Build a typed React component"
    • "Type this event handler"
    • "Create a generic Table/List/Modal"
    • "Use React 19 Server Components"
    • "Type-safe routing with TanStack/React Router"
    • "How do I type this hook?"
    • "React TypeScript best practices"
  3. Use the Gemini Skill for large context analysis

    main

    The Gemini skill provides access to Google's Gemini models via the Gemini CLI, specifically designed for tasks requiring massive context windows (up to 1M tokens) and advanced software engineering reasoning.

    When to use this skill:

    • Performing comprehensive code reviews across entire codebases.
    • Analyzing architectural plans or technical specifications.
    • Processing large documentation sets (>200k tokens).
    • Understanding complex relationships across many files.

    Activation Keywords: use Gemini, run Gemini, Gemini review, analyze with Gemini, big context, >200k tokens.

  4. Use the Difficult Conversations Skill

    main

    The difficult-workplace-conversations skill provides a structured framework for managing workplace conflicts, performance discussions, and sensitive feedback. It is designed to help users navigate emotionally charged or challenging professional interactions using a three-phase approach: Preparation, Delivery, and Followup.

    When to use this skill:

    • Preparing for challenging conversations with colleagues.
    • Addressing performance issues.
    • Delivering critical feedback to peers or managers.
    • Navigating team conflicts.
    • Discussing sensitive topics like salary, promotions, or terminations.
    • Handling emotional or defensive reactions.
    • Following up after difficult discussions.
    --- 
    name: difficult-workplace-conversations
    description: Structured approach to workplace conflicts, performance discussions, and challenging feedback using preparation-delivery-followup framework. Use when preparing for tough conversations, addressing conflicts, giving critical feedback, or navigating sensitive workplace discussions.
    allowed-tools: Read, Glob, Grep
    ---
  5. Use the Feedback Mastery skill for workplace conversations

    main

    The Feedback Mastery skill provides structured frameworks for navigating difficult workplace conversations, such as addressing performance issues, resolving conflicts, or managing stakeholder expectations. It is particularly useful in software engineering contexts for topics like code quality, missed deadlines, or technical disagreements.

    Trigger Phrases

    You can activate this skill using phrases like:

    • "How do I give feedback about..."
    • "I need to have a difficult conversation..."
    • "Help me address a performance issue..."
    • "How do I handle conflict with..."
    • "Prepare me for a 1:1 about..."
    • "How do I push back on unrealistic expectations..."
    • "Help me with expectation alignment..."
  6. Common use cases for Command Creator

    main

    The Command Creator is suitable for automating various workflows:

    • Development Workflows: Submitting PRs, fixing CI failures, running code reviews (linters/formatters), and deployment.
    • Project Automation: Project setup, documentation generation, testing suites, and release management (version bumping/changelogs).
    • Personal Productivity: Git cleanup (pruning remotes/merged branches), codebase analysis, and refactoring.
    • Team Collaboration: Environment setup, enforcing coding standards, and documenting architectural decisions.
  7. Understand the Skill Judge skill

    main
    The skill-judge skill is designed to evaluate the design quality of Agent Skills against official specifications and best practices. It is used for reviewing, auditing, or improving SKILL.md files and skill packages. It provides multi-dimensional scoring and actionable improvement suggestions based on patterns derived from over 17 official examples.
  8. Summary of Markdown Meme Techniques

    main

    This guide provides a framework for creating memes directly within Markdown-based blog posts or documentation.

    Core Strategies

    • Textual Memes: Use core Markdown syntax (code fences, blockquotes, emphasis, horizontal rules) to create fast, accessible, and version-controllable memes.
    • Image Memes: Use memegen.link URLs to embed image memes without requiring local file uploads or storage.
    • Comedic Pacing: Mix text and image formats strategically to control the rhythm of the content.
    • Accessibility: Always provide alt text for image-based memes to ensure accessibility.
    • Formatting: Use whitespace and spacing as a comedic tool and keep text concise for maximum impact.
  9. Use the feedback-mastery skill

    main

    The feedback-mastery skill provides structured frameworks for navigating difficult workplace conversations and delivering effective feedback. It is designed to help users prepare for, execute, and follow up on sensitive interactions such as performance reviews, conflict resolution, or expectation setting.

    When to use this skill:

    • Preparing to give feedback to a colleague or direct report.
    • Addressing performance issues or missed expectations.
    • Navigating conflict between team members.
    • Having 1:1 conversations about sensitive topics.
    • Receiving feedback and wanting to respond constructively.
    • Managing expectations with stakeholders.

    Allowed Tools:

    • Read
    • Glob
    • Grep
  10. Use the Writing Clearly and Concisely skill

    main

    The writing-clearly-and-concisely skill is designed for generating or editing prose intended for human readers. Use this skill for documentation (READMEs, technical explanations), commit messages, PR descriptions, error messages, UI copy, and reports.

    When to use

    Apply this skill whenever you are writing sentences for a human to read. It focuses on applying Strunk's rules for clarity and avoiding common LLM-generated writing patterns.

  11. Use the Mermaid Diagrams Skill

    main

    The Mermaid Diagrams Skill allows you to create professional software diagrams using text-based syntax. This enables version-controlled, maintainable visualizations of system architecture, code structure, database models, and technical flows.

    Trigger Phrases

    The skill activates when you use terms such as:

    • diagram, visualize, model, map out, show the flow
    • architecture diagram, class diagram, sequence diagram, flowchart
    • database schema, ERD, entity relationship
    • system design, data model, domain model
  12. Use the react-useeffect skill for React best practices

    main
    The react-useeffect skill provides guidance on React useEffect best practices based on official documentation. It is designed to assist when writing or reviewing code involving useEffect, useState for derived values, data fetching, or state synchronization. It specifically helps identify when an Effect is unnecessary and suggests better alternatives.