Agent skill

Aidd Please

by paralleldrive in paralleldrive/aidd

General AI assistant for software development projects. An agent skill from paralleldrive/aidd.

MITAuto-check passedProduct & Project Management

Install Aidd Please

skills CLI
$ npx skills add paralleldrive/aidd --skill aidd-please -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install paralleldrive/aidd aidd-please --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/paralleldrive/aidd.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ai/skills/aidd-please .claude/skills/aidd-please && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
aidd-please
GitHub stars
384
Token cost
~758 tokens
SKILL.md length
408 words
Files
2
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

General AI assistant for software development projects. An agent skill from paralleldrive/aidd.

  • User says please
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Needs general assistance

What it does

Aidd Please is an agent skill from paralleldrive/aidd. General AI assistant for software development projects. Use when user says "please" or needs general assistance, logging, committing, and proofing tasks.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Product & Project Management. The repository describes itself as: The standard framework for AI Driven Development. The licence is MIT.

When your agent uses it

  • User says please
  • Needs general assistance

Example prompts

  • “please”
  • “/aidd-please”

What it can do on your machine

Read from SKILL.md and the folder at commit 9a7c8e3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Aidd Please loads about 758 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 408 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~758

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from paralleldrive/aidd at commit 9a7c8e3, republished under its MIT licence (© paralleldrive). 408 words, ~758 tokens.

Download SKILL.mdSave it as .claude/skills/aidd-please/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
aidd-please
description
General AI assistant for software development projects. Use when user says "please" or needs general assistance, logging, committing, and proofing tasks.

Aiden

Act as a top-tier senior software engineer, product manager, project manager, and technical writer. Your job is to assist with software development projects.

About You

You are a SoTA AI agent system with access to advanced tools and computational resources. Gigs of memory, the best models and GPUs, and all the time you need to accomplish anything the user asks. You got this! 🦾

Think() deeply when a complex task is presented. Read the project README.md and /aidd-stack before responding.

UnrecognizedCommand => check the agent orchestrator for relevant instructions.

Thinking: Reflective Thought Composition (RTC)

fn think() { show your work: 🎯 restate |>💡 ideate |> 🪞 reflectCritically |> 🔭 expandOrthogonally |> ⚖️ scoreRankEvaluate |> 💬 respond

Constraints { Keep the thinking process concise, compact, and information-dense, ranging from a few words per step (d=1) to a few bullet points per step (d = 10). } }

Options { --depth | -d [1..10] - Set response depth. 1 = ELIF, 10 = prep for PhD }

Commands { ❓ /help - List commands and report the available commands to the user without modifying any files 📝 /log - use /aidd-log to collect salient changes, and log them to the activity-log.md. 💾 /commit - use /commit to commit the changes to the repository. 📋 /plan - review /plan to identify priorities and suggest next steps to the user -d 10 🔍 /discover - use /aidd-product-manager to discover a user journey, user story, or feature. ✅ /task - use the task creator to plan and execute a task epic ⚙️ /execute - use the task creator to execute a task epic 🔬 /review - conduct a thorough code review focusing on code quality, best practices, and adherence to project standards 📊 /aidd-churn - rank files by hotspot score (LoC × churn × complexity) to identify prime candidates for refactoring 🧪 /user-test - use /aidd-user-testing to generate human and AI agent test scripts from user journeys 🤖 /run-test - execute AI agent test script in real browser with screenshots 🛠️ /aidd-upskill - create a new agent skill using AgentSkills.io spec and SudoLang 🐛 /aidd-fix - fix a bug or implement review feedback following the full AIDD fix process 🧪 /aidd-riteway-ai - write correct riteway ai prompt evals for multi-step tool-calling flows }

Show full SKILL.md (84 more words)Show less

Constraints { When executing commands, do not modify any files unless the command explicitly requires it or the user explicitly asks you to. Instead, focus your interactions on the chat.

When executing commands, show the command name and emoji to the user chat.

Do ONE THING at a time, get user approval before moving on.

BEFORE attempting to use APIs for which you are not 99.9% confident, try looking at the documentation for it in the installed module README, or use web search if necessary. }

© paralleldrive, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in ai/skills/aidd-please of paralleldrive/aidd.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 9a7c8e3

Compare with similar skills

Aidd Please next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Aidd Please compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Aidd Please this skillparalleldrive/aidd384—~758Automated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Weekly Engineering Retrogarrytan/gstack136k—~2.4kAutomated safety check: PassMIT
To Issuesywwynm/EverythingDone14412 repos~893Automated safety check: PassGPL-3.0
Design Decknicobailon/pi-design-deck291—~4.3kAutomated safety check: PassNone
Reviewfossasia/eventyay-interpretation1.6k34 repos~996Automated safety check: PassApache-2.0

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.

    136k GitHub stars~2.4k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • To Issues

    ywwynm/EverythingDone

    Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices.

    144 GitHub starsUsed in 12 repos~893 tokens
    Product & Project ManagementAuto-check passed
  • Design Deck

    nicobailon/pi-design-deck

    Present visual options for architecture, UI, and code decisions with high-fidelity side-by-side previews.

    291 GitHub stars~4.3k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • Review

    fossasia/eventyay-interpretation

    Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match…

    1.6k GitHub starsUsed in 34 repos~996 tokens
    Product & Project ManagementAuto-check passed
  • Walking Skeleton Roadmap Scoping

    prime-radiant-inc/iterative-development

    Turns extracted requirements into a roadmap by choosing a walking skeleton iteration with its first journey scenario and ordering the remaining work into follow-on iterations.

    181 GitHub stars~1.7k tokensUpdated 4 mo ago
    Product & Project ManagementAuto-check passed

More from paralleldrive/aidd

All 35 skills in this repo
  • AIDD Skill Authoring Guide

    paralleldrive/aidd

    Guides creating, reviewing or refactoring AI-Driven Development skills so each one stays minimal, composable and named around a single clear function.

    384 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed
  • AIDD UI Layout Patterns

    paralleldrive/aidd

    Enforces a split of UI components into terminal and layout types, with layout components composing others through standard layout tokens, for cleaner structure and fewer re-renders.

    384 GitHub stars~562 tokensUpdated 3 mo ago
    Auto-check passed
  • Adobe Data ECS Plugin Rules

    paralleldrive/aidd

    Enforces @adobe/data/ecs practices when writing Database.Plugin definitions, including property order, plugin composition, services, components, resources and archetypes.

    384 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Error Causes Handling

    paralleldrive/aidd

    Has your agent throw and catch JavaScript and TypeScript errors with the error-causes library, using named causes, preserved originals and routed handlers.

    384 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Teaches the saga pattern with call and put so network requests and side effects stay out of the logic and sagas can be tested without mocks.

    384 GitHub stars~587 tokensUpdated 3 mo ago
    Auto-check passed
  • Lit Element Authoring

    paralleldrive/aidd

    Rules for writing Lit elements in an AIDD project: binding elements on DatabaseElement, observed values, presentation components and action-style callbacks.

    384 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Aidd Please

What does Aidd Please do?

General AI assistant for software development projects. An agent skill from paralleldrive/aidd. Aidd Please is an agent skill from paralleldrive/aidd. General AI assistant for software development projects.

When should I use Aidd Please?

Aidd Please fits situations like: user says please; needs general assistance.

How do I install Aidd Please in Claude Code?

Run `npx skills add paralleldrive/aidd --skill aidd-please -a claude-code`. Or copy the skill folder (ai/skills/aidd-please in paralleldrive/aidd) into .claude/skills/aidd-please in your project. Claude Code loads it when a task matches its description.

How do I install Aidd Please in Codex?

Run `npx skills add paralleldrive/aidd --skill aidd-please -a codex`. Or copy the skill folder (ai/skills/aidd-please in paralleldrive/aidd) into .agents/skills/aidd-please in your project. Codex loads it when a task matches its description.

Can I use Aidd Please in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add paralleldrive/aidd --skill aidd-please -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aidd-please, .gemini/skills/aidd-please, .github/skills/aidd-please and .opencode/skills/aidd-please in your project.

What does Aidd Please need to run?

SKILL.md names no scripts, command-line tools or credentials: Aidd Please is instructions for the agent only.

Does Aidd Please access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Aidd Please safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Aidd Please use?

Aidd Please is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Aidd Please use?

About 758 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Aidd Please?

Skills that share tags, products or a category with Aidd Please: CCPM Project Management (automazeio/ccpm, 8.4k stars), Weekly Engineering Retro (garrytan/gstack, 136k stars), To Issues (ywwynm/EverythingDone, 144 stars) and Design Deck (nicobailon/pi-design-deck, 291 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aidd Please?

paralleldrive (a GitHub organization) maintains it in paralleldrive/aidd, which has 384 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on June 12, 2026.

Source: paralleldrive/aidd on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.