Skip to content

README.md

Latest commit

 

History

History
80 lines (55 loc) · 2.59 KB

README.md

File metadata and controls

80 lines (55 loc) · 2.59 KB
Raw

Telegram Website Feedback Skill

A reusable Hermes Agent skill for turning captioned Telegram screenshots into structured website-feedback rounds, Markdown implementation briefs, image-embedded PDFs, and optional coding-agent inbox copies.

What it does

  • Saves one screenshot per feedback item
  • Parses optional tags and page paths from captions
  • Uses vision to add a factual description
  • Maintains sequential Markdown logs by testing round
  • Generates grouped Markdown reports and review PDFs
  • Keeps screenshot links relative
  • Optionally copies completed rounds into a dedicated coding-agent feedback directory
  • Supports /report, /redo, and /feedback-status through configured aliases

Install locally

Copy the telegram-website-feedback-bot/ directory into your Hermes skills directory, for example:

mkdir -p ~/.hermes/skills/productivity
cp -R telegram-website-feedback-bot ~/.hermes/skills/productivity/

Start a fresh Hermes session or run /reload-skills where supported.

Install the PDF dependencies:

python -m pip install -r ~/.hermes/skills/productivity/telegram-website-feedback-bot/references/requirements.txt

Initialize the pipeline:

python ~/.hermes/skills/productivity/telegram-website-feedback-bot/scripts/setup_pipeline.py \
  --root ~/website-feedback \
  --site-name "My Website" \
  --install-aliases

Optional coding-agent inbox:

python ~/.hermes/skills/productivity/telegram-website-feedback-bot/scripts/setup_pipeline.py \
  --root ~/website-feedback \
  --site-name "My Website" \
  --project-inbox ~/my-project/feedback \
  --install-aliases

Restart the gateway once after adding aliases, then test /feedback-status in Telegram.

Telegram prerequisites

Configure Telegram through Hermes's gateway setup wizard. Bot credentials and allowed user IDs belong in each user's own Hermes configuration and are never included in this package.

Native command fallback

If aliases have not been installed or the gateway has not restarted:

/telegram-website-feedback-bot /report
/telegram-website-feedback-bot /feedback-status
/telegram-website-feedback-bot /redo ITEM-1-001 replacement note

Share or publish

The package can be hosted in a GitHub repository and installed from a direct SKILL.md URL. Hermes also supports publishing a skill directory:

hermes skills publish telegram-website-feedback-bot --to github --repo OWNER/REPOSITORY

Review the package before publishing. It intentionally contains no bot tokens, chat IDs, user data, screenshots, site-specific content, or machine-specific paths.

License

MIT