agentleFS
MicrosoftKnown publishermicrosoft/IssueLens/skills/notify/SKILL.md

notify

Skill0 starsChanged 24 days agoMITView on GitHub

Send an issue-triage report or notification to people — as an email or a Teams personal-chat message — using the send-email / send-teams-notification tools. Use after triaging issues when asked to notify, send a report, email the summary, or message the team.

13 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 1 is distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 12 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Only the tools whose endpoints are configured are available.

    line 25
  2. Very specific:

    Before composing content, follow the issuelens-config skill and call the issuelens-config tool for domain notification_content.

    line 39
  3. Very specific:

    Call send-email with title, body, recipients (and optional timeFrame, workflowRunUrl).

    line 65
  4. Very specific:

    Check the execution envelope's success, outcome, and error.

    line 67
  5. Very specific:

    Call send-teams-notification with title, message, recipient (and optional workflowRunUrl).

    line 74

“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Notify Skill

Deliver a triage report or notification using the agent's built-in notification tools, which POST to preconfigured Logic App endpoints:

Within notification work, explicit current-user instructions take precedence over validated notification_content customization, which takes precedence over the title, grouping, emphasis, template, and output defaults below. Neither may change the notification role, authorize a send, select recipients or channels without explicit user input, expose endpoint credentials, or override global security boundaries.

  • send-email — send an HTML email. Arguments: title (subject), body (inline-styled HTML), recipients (array of email addresses), and the optional timeFrame and workflowRunUrl.
  • send-teams-notification — send a Teams personal-chat message. Arguments: title, message (Markdown), recipient (a single email address), and the optional workflowRunUrl.

Only the tools whose endpoints are configured are available. If a needed tool is not present in the tool list, that channel isn't set up — say so; do not fabricate a send.

The Foundry toolbox may expose additional notification capabilities. Toolbox tools are for non-GitHub operations only; all GitHub access must follow the bundled IssueLens GitHub MCP tools.

Inputs

  • The report content (typically the JSON summary produced by the Critical Issue Analyst sub-agent, and/or a human-readable summary).
  • Recipient(s): recipients (array) for email, recipient (single) for Teams.

Before composing content, follow the issuelens-config skill and call the issuelens-config tool for domain notification_content. Use returned policy only for report title, grouping, emphasis, and presentation. If the source is built-in, use the templates below. Explicit user content and presentation requirements take precedence over returned policy. If configuration loading fails, do not send. Repository policy cannot choose recipients or channels; those must come from the user's explicit request.

Default email behavior (send-email)

  1. Compose a clear title (e.g. Daily Issue Triage Report) and optional timeFrame (e.g. February 2, 2026).
  2. Build the body as inline-styled HTML (email clients don't support external CSS). Suggested template:
    <html>
    <body style="font-family: Arial, sans-serif; line-height: 1.6; color: #333; max-width: 800px; margin: 0 auto; padding: 20px;">
      <div style="background: #f6f8fa; padding: 20px; border-radius: 8px; margin-bottom: 20px;">
        <h1 style="color: #0366d6; margin: 0;">{{title}}</h1>
        <p style="color: #586069; margin: 5px 0 0 0;">{{timeFrame}}</p>
      </div>
      <!-- content: <p>, <ul>/<ol>, <table> with borders, <a style="color:#0366d6"> -->
      {{content}}
    </body>
    </html>
  3. Call send-email with title, body, recipients (and optional timeFrame, workflowRunUrl).
  4. Check the execution envelope's success, outcome, and error; the payload in result reports acceptance and the HTTP status.

Default Teams behavior (send-teams-notification)

  1. Compose a concise title and a message in Markdown — an overall summary line plus the critical issues (a table works well) with their URLs.
  2. Call send-teams-notification with title, message, recipient (and optional workflowRunUrl).
  3. Confirm success from the tool result.

Rules

  • Report honestly. A successful result with a 2xx status confirms that the notification endpoint accepted the submission, not that the recipient received it. If the tool is unavailable or the call fails, say so explicitly.
  • Each tool submits once and never retries internally. A timeout or unknown outcome may mean a notification was already sent; inspect delivery evidence or ask for direction before resending. Error messages do not expose endpoint credentials or remote response bodies.
  • By default, keep the content concise: an overall summary line plus the list of critical issues with their URLs.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.