implement

Implement features, fix bugs, and modify production source code in S3Mock. Use when asked to add functionality, change behavior, or modify source files in server/, integration-tests/, or testsupport/. Not for documentation-only or test-only changes. Orchestrates lint, test, and document skills as part of the complete workflow.

Jump to install Review files

Repository: adobe/S3Mock
Last source activity: July 27, 2026 at 17:34
Detected SKILL.md language: English
Stars: 1,174
Forks: 200

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install only the Agent Skill at https://github.com/adobe/S3Mock/tree/main/.agents/skills/implement.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/adobe/S3Mock --skill implement

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

name: implement
description: Implement features, fix bugs, and modify production source code in S3Mock. Use when asked to add functionality, change behavior, or modify source files in server/, integration-tests/, or testsupport/. Not for documentation-only or test-only changes. Orchestrates lint, test, and document skills as part of the complete workflow.

# Implementation Skill ## Entry Criteria Use for new functionality, bug fixes, or behavior changes in `server/`, `integration-tests/`, or `testsupport/`. Not for test-only or documentation-only changes — use the `test` or `document` skill instead. ## Before Starting 1. Read root `AGENTS.md` and the relevant module `AGENTS.md` (`server/AGENTS.md`, `integration-tests/AGENTS.md`, or `testsupport/AGENTS.md`). 2. For a new S3 operation, verify element names and behavior against the [AWS S3 API docs](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html). 3. Review existing similar implementations for patterns to follow. 4. If nearby code would benefit from cleanup before adding new code, invoke the **`refactor` skill** first. ## Execution Steps 1. For a new S3 operation, follow **[server/AGENTS.md § Implementation Flow](../../../server/AGENTS.md)** (DTO → Store → Service → Controller → IT) — do not skip layers or add logic in the wrong layer. 2. Update the copyright year in every modified file (`INVARIANTS.md`). 3. Invoke the **`lint` skill**. 4. Invoke the **`test` skill** to add or update unit and integration tests. 5. Invoke the **`document` skill** to update `CHANGELOG.md`, `README.md`, and `AGENTS.md` where applicable. ## Completion Criteria - [ ] Code compiles (`make skip-docker`) - [ ] Unit tests pass (`make test`); integration tests pass (`make integration-tests`) - [ ] Lint gates pass (via `lint` skill) - [ ] Copyright year updated in every modified file - [ ] Tests added/updated (via `test` skill); docs updated (via `document` skill) ## Troubleshooting - **Build fails**: confirm JDK 25 is active; run `make format` and fix remaining lint errors. - **XML test failures**: a compile check is not sufficient (`INVARIANTS.md`) — run integration tests to confirm serialized output. - **Docker fails**: use `make skip-docker` to isolate the build from Docker issues. ## Resources - [`AGENTS.md`](../../../AGENTS.md), [`INVARIANTS.md`](../../../INVARIANTS.md) - Relevant module `AGENTS.md` (`server/AGENTS.md`, `integration-tests/AGENTS.md`, or `testsupport/AGENTS.md`)

View on GitHub

Back to search Back to installation

document

Generate and update S3Mock project documentation. Use when asked to document code, update CHANGELOG.md, update README.md, update AGENTS.md files, or fix formatting, wording, or style in any existing documentation file. Also invoked at the end of the implement skill workflow.

2026-07-27

lint

Fix code style issues and ensure linting CI gates pass in S3Mock. Use when ktlint or Checkstyle violations are reported, when asked to fix formatting, or as a required final step after any code change. Runs ktlint for Kotlin source files and Checkstyle for Java and XML files.

2026-07-27

refactor

Improve code readability, enforce idiomatic Kotlin conventions, and enhance documentation quality in S3Mock without changing behavior. Use when asked to clean up code, improve naming, add KDoc, or align with Kotlin/project idioms. Also invoked by the implement and test skills before adding new code to messy areas.

2026-07-27

View all from this repository

implement

Source facts

Install options

Install with an AI assistant

Review the source files

More from this repository

Install with an AI assistant

More from this repository