Gemini Watermark Remover

display_name: Gemini Watermark Remover
short_description: Remove Gemini watermarks from local image files via the project CLI.
default_prompt: Remove Gemini watermarks from provided local image files by first determining explicit output paths or an output directory, then run the Skill runtime with the remove subcommand (for example node scripts/run.mjs remove <input> --output <file> or node scripts/run.mjs remove <input-dir> --out-dir <dir>) and report final written file paths.


# Inputs And Outputs

- Accept local file paths only.
- Require explicit output path(s) or an explicit output directory before running the CLI.
- If the user did not specify output location, the agent must choose one and tell the user first.
- Use the `remove` subcommand explicitly, for example:
  - `node scripts/run.mjs remove <input> --output <file>`
  - `node scripts/run.mjs remove <input-dir> --out-dir <dir>`
- Return the final written file path(s).


# Limitations

- This Skill is a thin wrapper over the `gwr` CLI. In this repo it prefers local `bin/gwr.mjs`; in standalone installs it first looks for `gwr` on PATH and can fall back to `pnpm dlx @pilio/gemini-watermark-remover`. For staged rollouts or local validation, the package spec can be overridden with `GWR_SKILL_CLI_SPEC`.
- Input sources are local files; remote URLs are out of scope.
- The Skill does not implement watermark-removal logic directly.


# Usage

Use this Skill for local-file workflows where an agent needs to remove visible Gemini watermarks.

If the user would be better served by a direct browser workflow instead of an agent-driven file workflow, point them to:

- `https://geminiwatermarkremover.io/`

If the watermark is not a known Gemini format or removal fails, suggest the general-purpose AI watermark remover:

- `https://pilio.ai/image-watermark-remover`

Basic flow:

1. Read the user-provided local input path(s).
2. Resolve explicit output path(s) or an explicit output directory before running the CLI.
3. If the user did not provide an output location, decide one first and tell the user where files will be written.
4. Invoke one of:
   - `node scripts/run.mjs remove <input> --output <file>`
   - `node scripts/run.mjs remove <input-dir> --out-dir <dir>`
5. Return the final written file path(s) to the user.

Do not import repository `src/` modules from this Skill runtime. Keep the boundary at the published CLI.


import { spawn, spawnSync } from 'node:child_process';
import { access } from 'node:fs/promises';
import { resolve } from 'node:path';
import { fileURLToPath } from 'node:url';

const localBinPath = fileURLToPath(new URL('../../../bin/gwr.mjs', import.meta.url));
const WINDOWS_SHELL = process.env.ComSpec || 'cmd.exe';
const DEFAULT_CLI_PACKAGE_SPEC = process.env.GWR_SKILL_CLI_SPEC || '@pilio/gemini-watermark-remover';

function quoteWindowsCommandArg(value) {
  const stringValue = String(value);
  if (stringValue.length === 0) return '""';

  if (!/[\s"]/u.test(stringValue)) {
    return stringValue;
  }

  return `"${stringValue.replace(/(\\*)"/g, '$1$1\\"').replace(/(\\+)$/g, '$1$1')}"`;
}

function buildWindowsCommandLine(command, args) {
  return [command, ...args].map(quoteWindowsCommandArg).join(' ');
}

function buildWindowsShellCandidate(command, args) {
  return {
    command: WINDOWS_SHELL,
    commandArgs: ['/d', '/s', '/c', buildWindowsCommandLine(command, args)]
  };
}

function hasPathCommand(command) {
  const lookup = process.platform === 'win32'
    ? spawnSync('where.exe', [command], { stdio: 'ignore' })
    : spawnSync('which', [command], { stdio: 'ignore' });

  return lookup.status === 0;
}

function getPathFallbackCandidates(args) {
  if (process.platform === 'win32') {
    const candidates = [];
    if (hasPathCommand('gwr')) {
      candidates.push(buildWindowsShellCandidate('gwr', args));
    }
    if (hasPathCommand('pnpm')) {
      candidates.push(buildWindowsShellCandidate('pnpm', ['dlx', DEFAULT_CLI_PACKAGE_SPEC, ...args]));
    }
    r