Skip to content
Back to search

maheshwaripn

MarketplaceWorks with Claude CodeGitHub

Engineering workflows for task routing, implementation and release evidence.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/maheshwaripn--advanced-agent-skills/badge.svg)](/listings/maheshwaripn--advanced-agent-skills)

HTML

<a href="/listings/maheshwaripn--advanced-agent-skills"><img src="/api/listings/maheshwaripn--advanced-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

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.

.claude-plugin/marketplace.json · Manifest · 28 lines
  1. {
  2. "name": "maheshwaripn",
  3. "owner": {
  4. "name": "Prashant Maheshwari",
  5. "url": "https://pusaram.com/"
  6. },
  7. "description": "Engineering workflows for task routing, implementation and release evidence.",
  8. "plugins": [
  9. {
  10. "name": "advanced-agent-skills",
  11. "source": "./",
  12. "description": "Engineering workflows for task routing, implementation and release evidence.",
  13. "category": "engineering",
  14. "keywords": [
  15. "engineering",
  16. "skills",
  17. "tdd",
  18. "code-review",
  19. "grilling"
  20. ]
  21. },
  22. {
  23. "name": "vps-workflows",
  24. "source": "./packs/vps-workflows",
  25. "description": "Illustrated workflows for operations, research, media production and Claude host tasks."
  26. }
  27. ]
  28. }
README.md · README · 152 lines
  1. # Advanced Agent Skills
  2. Advanced Agent Skills is Prashant Maheshwari’s public collection of 85 skill definitions: 33 core workflows, 40 optional VPS workflows, 8 experimental skills and 4 reference tools. Start with `/askadvisor` to find a skill, or run `/setup-agent-skills` to configure a project’s issue tracker, triage labels, and documentation. [Maintainer’s website](https://pusaram.com/)
  3. ## Optional VPS workflow pack
  4. The [illustrated VPS catalog](packs/vps-workflows/README.md) maps 42 catalog rows to 40 companion skills and two existing core skills. The historical inventory total is unconfirmed. It includes operations, research, film production, scheduling, documents and host-specific workflows. Install the companion separately when needed.
  5. ## Use from this checkout
  6. On Linux, link the promoted skills into your chosen agent directory. Existing same-name entries are preserved and reported. Keep this checkout in place while using the links.
  7. ```bash
  8. python3 scripts/check.py
  9. bash scripts/link-skills.sh ~/.agents/skills
  10. # For Claude Code use ~/.claude/skills as the destination instead.
  11. ```
  12. For a local Claude marketplace install, run `claude plugin marketplace add .` from this checkout, followed by `claude plugin install advanced-agent-skills@maheshwaripn`. Choose one installation method per host.
  13. Try: “Use plan-effort to route a change that adds a field to our invoice export. A consumer still reads the old format.” Then, on the candidate revision, ask: “Use release-evidence to check that old and new consumers can both read the export.”
  14. See [the upstream review](REVIEW.md) for the baseline, changes and attribution. [Run the scenarios](EVALUATION.md) to evaluate a specific model.
  15. ## Reference
  16. User-invoked skills start when you request them. Model-invoked skills can also be selected by the agent when a task fits.
  17. ### Engineering
  18. Engineering workflows.
  19. **User-invoked**
  20. - [draft-release-notes](./skills/engineering/draft-release-notes/SKILL.md) — Write audience-facing release notes from a verified comparison between two revisions.
  21. - [evaluate-skill](./skills/engineering/evaluate-skill/SKILL.md) — Compare two skill or prompt revisions on paired cases and report regressions, reliability and cost.
  22. - [review-ui-journey](./skills/engineering/review-ui-journey/SKILL.md) — Evaluate a real user journey across interface states, keyboard navigation and responsive layouts.
  23. - [trace-architecture](./skills/engineering/trace-architecture/SKILL.md) — Trace one behavior across a codebase with revision-specific evidence and an explicit map of unknowns.
  24. - [plan-effort](./skills/engineering/plan-effort/SKILL.md) selects an effort level and verification path.
  25. - [release-evidence](./skills/engineering/release-evidence/SKILL.md) checks a release candidate and its recovery evidence.
  26. - **[askadvisor](./skills/engineering/askadvisor/SKILL.md)**: Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.
  27. - **[grill-with-docs](./skills/engineering/grill-with-docs/SKILL.md)**: Grilling session that also builds your project's domain model, sharpening terminology and updating `GLOSSARY.md` and ADRs inline.
  28. - **[triage](./skills/engineering/triage/SKILL.md)**: Move issues through a state machine of triage roles.
  29. - **[improve-codebase-architecture](./skills/engineering/improve-codebase-architecture/SKILL.md)**: Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
  30. - **[setup-agent-skills](./skills/engineering/setup-agent-skills/SKILL.md)**: Configure this repo for the engineering skills (issue tracker, triage labels, domain doc layout). Run once per repo before using the other engineering skills.
  31. - **[to-spec](./skills/engineering/to-spec/SKILL.md)**: Turn the current conversation into a spec and publish it to the issue tracker. No interview, just synthesizes what you've already discussed.
  32. - **[to-tickets](./skills/engineering/to-tickets/SKILL.md)**: Break any plan, spec, or conversation into a set of tracer-bullet tickets, each declaring its blocking edges, written as text in a local file, or as native blocking links on a real tracker.
  33. - **[implement](./skills/engineering/implement/SKILL.md)**: Build the work described by a spec or set of tickets, driving `/tdd` at pre-agreed seams and closing out with `/code-review` before committing.
  34. - **[implement-spec](./skills/engineering/implement-spec/SKILL.md)**: Implement a whole spec on one integration branch. Works the tickets as a task graph, running implementer subagents across the ready frontier for maximum concurrency, then closes out with `/code-review`.
  35. - **[wayfinder](./skills/engineering/wayfinder/SKILL.md)**: Plan a huge chunk of work, more than one agent session can hold, as a shared map of decision tickets on the issue tracker, and resolve them one at a time until the way to the destination is clear.
  36. - **[retro](./skills/engineering/retro/SKILL.md)**: Suggest improvements to the coding agent's environment (navigation, automated checks, coding standards, steering files, tooling) after a session, most severe first.
  37. **Model-invoked**
  38. - **[prototype](./skills/engineering/prototype/SKILL.md)**: Build a throwaway prototype to answer a design question, either a single shareable HTML file for state/logic questions, or several radically different UI variations toggleable from one route.
  39. - **[diagnosing-bugs](./skills/engineering/diagnosing-bugs/SKILL.md)**: Disciplined diagnosis loop for hard bugs and performance regressions: build a feedback loop that goes red on this bug → minimise → hypothesise → instrument → fix → regression-test.
  40. - **[research](./skills/engineering/research/SKILL.md)**: Investigate a question against high-trust primary sources and capture the findings as a cited Markdown file in the repo, run as a background agent.
  41. - **[tdd](./skills/engineering/tdd/SKILL.md)**: Test-driven development with a red-green-refactor loop. Builds features or fixes bugs one vertical slice at a time.
  42. - **[domain-modeling](./skills/engineering/domain-modeling/SKILL.md)**: Actively build and sharpen a project's domain model: challenge terms against the glossary, stress-test with edge-case scenarios, and update `GLOSSARY.md` and ADRs inline.
  43. - **[codebase-design](./skills/engineering/codebase-design/SKILL.md)**: Shared discipline and vocabulary for designing deep modules: a lot of behaviour behind a small interface, placed at a clean seam, testable through that interface.
  44. - **[code-review](./skills/engineering/code-review/SKILL.md)**: Two-axis review of the diff since a fixed point: **Standards** (does it follow the repo's coding standards, plus a Fowler smell baseline?) and **Spec** (does it faithfully implement the originating issue/spec?), run as parallel sub-agents so neither pollutes the other.
  45. - **[pr](./skills/engineering/pr/SKILL.md)**: The shape a pull request body should take: a summary as the smallest visual that makes the change clear, before/after evidence that it works, and a merge-danger call (one-way or two-way door, plus blast radius).
  46. - **[wizard](./skills/engineering/wizard/SKILL.md)**: Generate an interactive bash wizard that walks a human through steps only they can perform: provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover.
  47. ### Productivity
  48. General workflow tools, not code-specific.
  49. **User-invoked**
  50. - **[grill-me](./skills/productivity/grill-me/SKILL.md)**: Get relentlessly interviewed about a plan or design until every branch of the design tree is resolved.
  51. - **[handoff](./skills/productivity/handoff/SKILL.md)**: Compact the current conversation into a handoff document so another agent can continue the work.
  52. - **[teach](./skills/productivity/teach/SKILL.md)**: Teach the user a new skill or concept over multiple sessions, using the current directory as a stateful teaching workspace.
  53. - **[to-questionnaire](./skills/productivity/to-questionnaire/SKILL.md)**: Turn a decision you can't answer alone into a Markdown questionnaire for the one person who can, filled in async, or together over a meeting. It grills you about the send (who it's for, what you need back), not the subject.
  54. - **[wait-what](./skills/productivity/wait-what/SKILL.md)**: Fire this the moment a message doesn't land. The agent re-pitches it with the context you're missing, in plain English, using your `GLOSSARY.md` vocabulary.
  55. **Model-invoked**
  56. - **[grilling](./skills/productivity/grilling/SKILL.md)**: Interview the user relentlessly about a plan, decision, or idea until every branch of the design tree is resolved. The reusable interview primitive behind `grill-me`, `grill-with-docs`, `triage`, `wayfinder` and `improve-codebase-architecture`.
  57. - **[writing-for-agents](./skills/productivity/writing-for-agents/SKILL.md)**: Writing documents for agents: skills, AGENTS.md/CLAUDE.md, and any doc an agent reaches by a pointer.
  58. [External skill review and selection decisions](docs/catalog-review.md)
  59. ## Optional VPS skills
  60. Install the companion with `claude plugin install vps-workflows@maheshwaripn` after registering the local marketplace. Examples are illustrative. Source status and host requirements are recorded in the [VPS reconciliation](packs/vps-workflows/RECONCILIATION.md).
  61. | Area | Skill | When to use it | Example or acceptance check |
  62. | --- | --- | --- | --- |
  63. | Workspace | [workspace-edit](packs/vps-workflows/skills/workspace-edit/SKILL.md) | Change a native Google Workspace file through an authorized connector. | The same spreadsheet ID now contains the renamed tab and its original formulas. |
  64. | Operations | [dhan-token-triage](packs/vps-workflows/skills/dhan-token-triage/SKILL.md) | Diagnose an authentication alert using redacted status evidence. | Show the missed run, distinguish suspected expiry from confirmed failure, and name the next read-only check. |
  65. | Research | [quant-research-protocol](packs/vps-workflows/skills/quant-research-protocol/SKILL.md) | Evaluate a pre-registered trading hypothesis. | Report the failed gate and retain the sealed sample. |
  66. | Operations | [site-publish](packs/vps-workflows/skills/site-publish/SKILL.md) | Prepare or execute a scoped static-site release. | Hold the release and identify the broken link and previous restore point. |
  67. | Studio | [studio-story-bible](packs/vps-workflows/skills/studio-story-bible/SKILL.md) | Establish the narrative and visual canon for a production. | Create a character and prop sheet that fixes the radio color and marks its repair state per scene. |
  68. | Studio | [studio-screenplay](packs/vps-workflows/skills/studio-screenplay/SKILL.md) | Turn an approved premise into filmable scenes. | A timed scene reaches the repair payoff without dialogue in the final beat. |
  69. | Studio | [studio-shotlist](packs/vps-workflows/skills/studio-shotlist/SKILL.md) | Plan camera coverage before rendering. | Two or more numbered shots add to twelve seconds and preserve the hand holding the radio. |
  70. | Studio | [studio-budget](packs/vps-workflows/skills/studio-budget/SKILL.md) | Estimate production spend and enforce an agreed cap. | Flag a 2-credit overrun and propose a smaller batch within the remaining 8. |
  71. | Studio | [studio-render](packs/vps-workflows/skills/studio-render/SKILL.md) | Prepare and track a reproducible render batch. | Queue only S03 for a permitted retry and keep the accepted S02 asset. |
  72. | Studio | [studio-audio](packs/vps-workflows/skills/studio-audio/SKILL.md) | Plan and verify a soundtrack against picture timing. | Move or attenuate the cue, then verify the line and peak level on the new mix. |
  73. | Studio | [studio-consistency](packs/vps-workflows/skills/studio-consistency/SKILL.md) | Review continuity across adjacent shots. | Record both shot IDs and the conflicting frames, then request a targeted correction. |
  74. | Studio | [studio-assemble-qc](packs/vps-workflows/skills/studio-assemble-qc/SKILL.md) | Assemble accepted media and check delivery quality. | Identify the affected time range and require playback of the corrected export. |
  75. | Studio | [studio-showrunner](packs/vps-workflows/skills/studio-showrunner/SKILL.md) | Coordinate studio stages from premise to delivery. | Continue audio planning while marking paid rendering blocked by the unknown cost. |
  76. | Workflow | [task-router](packs/vps-workflows/skills/task-router/SKILL.md) | Choose direct work, a model recommendation or bounded delegation. | Assign independent document checks, then give the parent the test and final decision. |
  77. | Design | [dataviz](packs/vps-workflows/skills/dataviz/SKILL.md) | Design and verify a chart for a specific comparison. | A labeled rate chart includes denominators and a readable data table. |
  78. | Claude host | [config-change](packs/vps-workflows/skills/config-change/SKILL.md) | Change one scoped agent configuration setting. | A scoped diff and one sample run demonstrate the hook fires once. |
  79. | Claude host | [keyboard-shortcuts](packs/vps-workflows/skills/keyboard-shortcuts/SKILL.md) | Resolve or customize a keyboard shortcut. | Show the conflict and confirm both actions in their intended contexts. |
  80. | Engineering | [simplify-change](packs/vps-workflows/skills/simplify-change/SKILL.md) | Simplify a changed code path while preserving its behavior. | Unify only after tests capture both empty and nonempty cases. |
  81. | Claude host | [review-read-permissions](packs/vps-workflows/skills/review-read-permissions/SKILL.md) | Review recurring prompts for narrowly scoped read-only operations. | Recommend only the verified read form and show why a write still requires approval. |
  82. | Scheduling | [bounded-loop](packs/vps-workflows/skills/bounded-loop/SKILL.md) | Repeat an observable check within an active session. | Stop on a terminal result and report attempt count and last observed state. |
  83. | Scheduling | [scheduled-routine](packs/vps-workflows/skills/scheduled-routine/SKILL.md) | Set up a persistent future task when the host supports it. | One stored schedule has the correct time zone, next run and cancellation identifier. |
  84. | Engineering | [api-integration](packs/vps-workflows/skills/api-integration/SKILL.md) | Plan or update a Claude API integration. | A minimal example uses the verified SDK interface and handles an unavailable model. |
  85. | Browser | [chrome-session](packs/vps-workflows/skills/chrome-session/SKILL.md) | Perform a bounded task in an authorized Chrome session. | Report the visible review state and stop before order submission. |
  86. | Browser | [chrome-journey](packs/vps-workflows/skills/chrome-journey/SKILL.md) | Inspect a journey using a Chrome browser adapter. | Confirm whether the opened menu exposes the target item and keyboard focus. |
  87. | Browser | [embedded-browser](packs/vps-workflows/skills/embedded-browser/SKILL.md) | Use an embedded browser for a scoped site task. | Report the opened lesson heading or the reason the preview could not load. |
  88. | Browser | [desktop-journey](packs/vps-workflows/skills/desktop-journey/SKILL.md) | Verify a native desktop workflow through its UI. | Record the page count shown by the app or mark preview unavailable. |
  89. | Planning | [ai-workflow-design](packs/vps-workflows/skills/ai-workflow-design/SKILL.md) | Design an AI-assisted workflow with evidence of success. | Deliver a routing design and a labeled pilot set with an escalation condition. |
  90. | Research | [quant-study-design](packs/vps-workflows/skills/quant-study-design/SKILL.md) | Design a reproducible quantitative study. | Record all trials and require independent confirmation before crediting the apparent advantage. |
  91. | Documents | [document-drafting](packs/vps-workflows/skills/document-drafting/SKILL.md) | Draft a structured document for a defined audience. | Include options, decision owner, rationale and unresolved evidence. |
  92. | Documents | [word-document](packs/vps-workflows/skills/word-document/SKILL.md) | Create or edit a Word document with layout checks. | The DOCX reopens, headings are structured and the table fits the page. |
  93. | Knowledge | [context-import](packs/vps-workflows/skills/context-import/SKILL.md) | Import selected context with provenance. | Keep both dated claims until the authoritative revision is identified. |
  94. | Workflow | [morning-brief](packs/vps-workflows/skills/morning-brief/SKILL.md) | Prepare a dated morning brief from authorized sources. | List verified work items and identify the calendar coverage gap. |
  95. | Documents | [pdf-document](packs/vps-workflows/skills/pdf-document/SKILL.md) | Produce or inspect a PDF against delivery requirements. | Report the affected page and distinguish clipping observed in rendering from a suspected issue. |
  96. | Documents | [slide-deck](packs/vps-workflows/skills/slide-deck/SKILL.md) | Build a presentation around an audience decision. | A short deck shows the decision, trend and supporting evidence with readable labels. |
  97. | Engineering | [author-skill](packs/vps-workflows/skills/author-skill/SKILL.md) | Author a portable agent skill with an acceptance example. | A mismatch is reported and a file with no comparable totals yields insufficient evidence. |
  98. | Documents | [spreadsheet-workbook](packs/vps-workflows/skills/spreadsheet-workbook/SKILL.md) | Build or audit a spreadsheet with reproducible calculations. | Changing an input updates totals and missing capacity never produces a misleading percentage. |
  99. | Documents | [docs-connector-edit](packs/vps-workflows/skills/docs-connector-edit/SKILL.md) | Edit an existing Google Doc using its connector. | The intended section changes while the other occurrence is preserved. |
  100. | Claude host | [project-instructions](packs/vps-workflows/skills/project-instructions/SKILL.md) | Initialize project guidance from observed repository conventions. | Instructions reference the actual entry point and test command and preserve existing local guidance. |
  101. | Engineering | [defensive-review](packs/vps-workflows/skills/defensive-review/SKILL.md) | Review a pending change for defensive security issues. | Point to the missing guard and require a test confirming unauthorized requests are rejected. |
  102. | Engineering | [plugin-authoring](packs/vps-workflows/skills/plugin-authoring/SKILL.md) | Package skills into a host-compatible plugin. | Validation identifies the path and a corrected install discovers both commands. |
  103. ## Experimental skills
  104. Available for evaluation as individual skills. Their interfaces may change.
  105. - [chief-of-staff](skills/in-progress/chief-of-staff/SKILL.md) — Pursue a long-running goal in a single session by co-ordinating subagents.
  106. - [claude-handoff](skills/in-progress/claude-handoff/SKILL.md) — Hand the current conversation off to a fresh background agent that picks up the work immediately.
  107. - [loop-me](skills/in-progress/loop-me/SKILL.md) — Grill me about specs for the workflows I want to build, within this workspace.
  108. - [setup-ts-deep-modules](skills/in-progress/setup-ts-deep-modules/SKILL.md) — Wire dependency-cruiser into a TypeScript repo so each package is a deep module, with implementation hidden in subfolders and reachable only through its entry-point files. User-invoked.
  109. - [software-factory](skills/in-progress/software-factory/SKILL.md) — Shared language for designing a software factory: the tasks it runs and the services it plugs into.
  110. - [writing-beats](skills/in-progress/writing-beats/SKILL.md) — Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
  111. - [writing-fragments](skills/in-progress/writing-fragments/SKILL.md) — Writing, explore: mine raw fragments, no structure yet.
  112. - [writing-shape](skills/in-progress/writing-shape/SKILL.md) — Writing, exploit: shape raw material into an article, paragraph by paragraph.
  113. ## Reference tools
  114. Special-purpose workflows available in the source tree.
  115. - [git-guardrails-claude-code](skills/misc/git-guardrails-claude-code/SKILL.md) — Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
  116. - [migrate-to-shoehorn](skills/misc/migrate-to-shoehorn/SKILL.md) — Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.
  117. - [scaffold-exercises](skills/misc/scaffold-exercises/SKILL.md) — Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
  118. - [setup-pre-commit](skills/misc/setup-pre-commit/SKILL.md) — Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.