Find Relevant Skill

find-relevant-skill

When to use

Use this skill when the user asks whether this site has a skill for a task, or when the agent is about to handle a recurring or site-specific procedure and no loaded or listed local skill obviously covers it. Don't use it for one-off questions or small talk that don't call for a reusable procedure — the check adds a step that only pays off when a skill could plausibly exist.

This skill helps avoid missing reusable site-specific procedures before doing work directly.

Inputs

Use or infer:

• The user's current task or request
• The current site context
• Any skills already listed in the conversation context
• Site skills stored wherever this site keeps its local skill library (commonly AgentAssets/Skills, but confirm the actual location for this site rather than assuming), when available
• Optional external reference: PnP SharePoint Skills repo at https://github.com/pnp/sharepoint-skills/tree/main/Skills

Steps

1. Restate the task in one short phrase.

2. Check known skills first.

   • Review loaded skills and site skills already present in context.
   • If a clearly relevant skill exists, activate it (however this environment loads a skill) and follow it.

3. If no known local skill clearly applies, inspect this site's skills.

   • Look for skill folders or SKILL.md files in this site's local skill library.
   • Read candidate skill descriptions or SKILL.md files as needed.
   • Don't guess skill names or claim a skill exists without finding it.

4. If no local skill matches, ask before checking the PnP SharePoint Skills repo.

   • Use the repo as a known external source for possible reusable skill patterns: https://github.com/pnp/sharepoint-skills/tree/main/Skills.
   • Always ask the user before searching or accessing the PnP repo, even if they previously approved web search in another turn.
   • Ask exactly: "Want me to search the PnP SharePoint Skills repo for a matching skill?"
   • Do not search or access the public web unless the user explicitly confirms for this specific check.
   • If the user confirms, search the web for the task plus the repo URL.
   • Don't claim an external skill exists unless it was found through an allowed web search or already provided in conversation.

5. Evaluate PnP repo results in this order.

   • Direct match: a PnP skill clearly solves the user's task. Recommend creating a local site version before using it.
   • Supporting match: no direct PnP skill solves the task, but one or more skills provide useful capabilities, safety rules, formats, patterns, or reusable guidance. Recommend installing those supporting skills locally when they'll be reused.
   • Reference pattern: no supporting skill should be installed, but a PnP skill contains a useful pattern. Apply the relevant pattern while creating a new local skill or proceeding with tools.
   • No match: nothing useful was found. Recommend creating a new skill from scratch or proceeding directly.

6. Check risks in any PnP skills or patterns before recommending installation or reuse.

   • Review the skill content, description, examples, and tool guidance when available.
   • Flag risks clearly for the user before creating or installing anything.
   • Look for these risk types:
     • Over-broad triggers that may fire on unrelated requests.
     • Instructions that bypass local site checks or ignore site context.
     • Instructions that encourage public web access without explicit user confirmation.
     • Tool names that don't exist in this environment or look mismatched.
     • Destructive or high-impact actions without confirmation, such as delete, overwrite, permissions changes, approvals, bulk edits, sharing, or publishing.
     • Guidance that could fabricate SharePoint IDs, URLs, paths, fields, list names, or file names.
     • Large or vague instructions that may inflate token usage or reduce reliability.
     • Duplicate or overlapping intent with existing local skills.
     • Unsafe HTML, external scripts, external CSS, remote images, or content that may not render under SharePoint CSP.
     • Missing output format, verification steps, or error handling.
   • Classify risk as Low, Medium, or High.
   • If risk is High, recommend adapting only the safe parts or not installing the skill.
   • If risk is Medium, recommend installing only after tightening triggers, adding confirmations, or removing risky instructions.
   • If risk is Low, mention any minor caveats and proceed with the recommendation.

7. Avoid reinventing the wheel.

   • Prefer installing/adapting relevant supporting skills from PnP over writing all guidance from scratch.
   • If creating a new local skill from scratch, include any relevant PnP-derived patterns in the instructions and cite them in the recommendation summary.
   • If multiple PnP skills are useful, separate them as: direct skill, supporting skill, and reference pattern.
   • Don't install broad or unrelated skills just because they sound similar.

8. Decide the best path.

   • If a relevant local skill exists, recommend it and activate it.
   • If a nearby local skill exists but doesn't fully cover the task, say what it covers and what's missing.
   • If a direct PnP skill exists, recommend creating a local site skill from it.
   • If supporting PnP skills exist, recommend installing/adapting them locally before creating the task-specific skill.
   • If only reference patterns exist, recommend applying those patterns to the new skill or direct work.
   • If risks are identified, include the risk rating and mitigation in the recommendation.
   • If no relevant skill or pattern exists, recommend creating a new skill from scratch or proceeding directly with tools.

9. If the user wants a new, supporting, or imported skill, create or adapt it directly.

   • If this site has its own dedicated skill-creation process already loaded or listed, use that; otherwise build the skill yourself following this site's normal skill format (frontmatter with name and description, then instructions).
   • Confirm purpose, triggers, output format, and verifiability before creating it.
   • If adapting a PnP skill, generalize it for this site and preserve only the relevant safe instructions.
   • If installing a supporting skill, keep its scope reusable and don't overfit it to the current task.
   • Remove or rewrite risky instructions before saving locally.

10. If tool checks fail or return empty, say so plainly.