Agent skill

Project Intelligence Root Cause Analysis

by pnp in pnp/sharepoint-skills

Reads the Change Events list and produces a full causal analysis of a project failure — a counterfactual root-cause test, the causal chain, intervention windows, and early-warning signal analysis —…

MITAuto-check passedDevelopment

Install Project Intelligence Root Cause Analysis

skills CLI
$ npx skills add pnp/sharepoint-skills --skill project-intelligence-root-cause-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pnp/sharepoint-skills project-intelligence-root-cause-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pnp/sharepoint-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Skills/project-intelligence-root-cause-analysis/project-intelligence-root-cause-analysis .claude/skills/project-intelligence-root-cause-analysis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-intelligence-root-cause-analysis
GitHub stars
131
Token cost
~3.5k tokens
SKILL.md length
1,838 words
Files
1
Skills in repo
51
Repo updated
First seen
Licence
MIT

At a glance

Reads the Change Events list and produces a full causal analysis of a project failure — a counterfactual root-cause test, the causal chain, intervention windows, and early-warning signal analysis —…

  • Works in 7 steps: Apply the Counterfactual Root Cause Test → Trace the Causal Chain → Map Intervention Windows → …
  • The user asks to find the root cause
  • SKILL.md covers Purpose, Inputs Required, Step 1 — Apply the… and Step 2 — Trace the Causal Chain, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Project Intelligence Root Cause Analysis is an agent skill from pnp/sharepoint-skills. Reads the Change Events list and produces a full causal analysis of a project failure — a counterfactual root-cause test, the causal chain, intervention windows, and early-warning signal analysis — ending in one actionable recommendation, persisted back to SharePoint. Use when the user asks to "find the root cause", "run root cause analysis on the project", "what went wrong and when did we know", "trace the causal chain", or "analyze the change log". Second stage of the Project Intelligence Engine; requires the…

Its SKILL.md is about 3.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Root cause analysis and Cloud office suites. It works with Microsoft SharePoint. The repository describes itself as: Skills for Copilot in SharePoint. The licence is MIT.

When your agent uses it

  • The user asks to find the root cause
  • Run root cause analysis on the project
  • What went wrong and when did we know
  • Trace the causal chain

Example prompts

  • “find the root cause”
  • “run root cause analysis on the project”
  • “what went wrong and when did we know”
  • “/project-intelligence-root-cause-analysis”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Apply the Counterfactual Root Cause Test
  2. Trace the Causal Chain
  3. Map Intervention Windows
  4. Early Warning Signal Analysis
  5. Failure Classification
  6. Produce the Recommendation
  7. Persist findings

What it can do on your machine

Read from SKILL.md and the folder at commit aa9eb14. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Project Intelligence Root Cause Analysis loads about 3.5k tokens when it runs. Until then it costs about 154 tokens; SKILL.md has 1,838 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~154
When it runs · the whole SKILL.md, loaded when a task matches
~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pnp/sharepoint-skills at commit aa9eb14, republished under its MIT licence (© pnp). 1,838 words, ~3,450 tokens.

Download SKILL.mdSave it as .claude/skills/project-intelligence-root-cause-analysis/SKILL.md (or your agent's skills folder).
name
project-intelligence-root-cause-analysis
description
Reads the Change Events list and produces a full causal analysis of a project failure — a counterfactual root-cause test, the causal chain, intervention windows, and early-warning signal analysis — ending in one actionable recommendation, persisted back to SharePoint. Use when the user asks to "find the root cause", "run root cause analysis on the project", "what went wrong and when did we know", "trace the causal chain", or "analyze the change log". Second stage of the Project Intelligence Engine; requires the Change Events list populated by Change Event Extraction.

Root Cause Analysis

Purpose

Take the change log in the Change Events list and produce a complete causal analysis: the root cause, the chain of events that followed from it, the signals that were present but not acted on, and a clear verdict on what could have prevented the outcome. Every finding must be traceable to a specific event number in the list.


Inputs Required

This skill reads from the Change Events list on this SharePoint site, populated by the Change Event Extraction skill. If the list is empty, run Change Event Extraction first.


Step 1 — Apply the Counterfactual Root Cause Test

For each HIGH signal-strength event in the change log, apply the following test:

"If this event had been handled correctly — escalated, change-ordered, validated, or resolved — would the downstream impact events still have occurred?"

Score each candidate event on three dimensions:

DimensionQuestionScore 1–5
Upstream dependencyHow many subsequent HIGH/MEDIUM events depend on this event being unresolved?5 = many downstream, 1 = isolated
Reversibility windowHow long after this event was it still possible to take corrective action before the impact became unavoidable?5 = long window, 1 = immediate lock-in
Documentation availabilityWas the information needed to recognise this as a problem present in the record at the time?5 = fully documented, 1 = not visible

The event with the highest combined score is the primary root cause. If two events score equally, prefer the earlier one (earlier failures compound more).

State which event number from the change log is the root cause, and show the scoring table.


Step 2 — Trace the Causal Chain

Starting from the root cause event, trace the forward sequence of events that led to the impact event (the moment the failure became visible or unavoidable).

For each step in the chain:

  • Reference the event number from the change log
  • State what happened
  • State why it followed from the previous step
  • Identify whether there was an intervention window at this step — a point at which the chain could still have been broken

Maximum 8 steps. If the chain is shorter, do not pad it.

Format:

[Event #N] → [What happened] → [Why this followed] → Intervention window: [Yes/No — if yes, what would have closed it]

Step 3 — Map Intervention Windows

For each point in the causal chain where intervention was still possible, produce a structured entry:

#DateIntervention pointWhat the record showedAction that was availableWho held the authorityWhy it was not taken (as documented)

For the "Why not taken" column: use only what the documents say. If there is no documented reason, state "Not documented — possible reasons include [infer from context, max 2 options]".


Step 4 — Early Warning Signal Analysis

From the change log, identify every event that was a signal of the eventual failure — regardless of whether it was labelled as such at the time.

For each signal, complete the following table:

#DateWeekSignalSource event #Disposition at the timeWhat should have been doneWho could have actedDetectability
HIGH / MEDIUM / LOW

Detectability — was the signal visible to a normally attentive PM or delivery lead?

  • HIGH: the signal was explicit and named in a document
  • MEDIUM: the signal required connecting two or more documented facts
  • LOW: the signal was present only in hindsight, or buried in a technical appendix unlikely to be read

After the table, state:

  • Total signals identified
  • Signals with HIGH detectability that were not acted on (these represent the clearest governance failures)
  • Average lag in weeks between first HIGH-detectability signal and the impact event

Step 5 — Failure Classification

Classify the failure on two axes:

Primary failure type — select the most accurate:

  • Scope creep: undocumented additions to agreed deliverables
  • Assumption failure: a baseline assumption was accepted without validation and proved materially wrong
  • Governance failure: change control processes were not followed when they should have been
  • Technical underestimation: complexity or volume was not anticipated and not discovered until late
  • Resource / dependency failure: a third-party dependency, unavailability, or skill gap caused the failure
  • Communication failure: decisions were made but not documented, leading to misaligned expectations
  • Compound failure: multiple types contributed — specify which two or three, and which was primary

Secondary dimensions (rate each 1–5):

DimensionRatingNotes
Preventability1–55 = entirely preventable with standard PM practice; 1 = unforeseeable
Detectability1–55 = signals were loud and explicit; 1 = failure was hidden until impact
Governance compliance1–55 = all decisions properly governed; 1 = none
Documentation completeness1–55 = complete record; 1 = reconstructed from memory

State each rating and a one-sentence justification.


Step 6 — Produce the Recommendation

State a single primary recommendation — the one action, if implemented, that would most have changed the outcome.

Structure the recommendation as:

RECOMMENDATION [One sentence — the specific action]

When to implement: [At which point in the engagement — e.g., "before sign-off on the project plan", "at the Week 2 discovery workshop close"]

Owner: [Role responsible for implementing this — be specific, e.g., "Engagement Manager", "Data Architect", "Client Sponsor"]

What it changes: [One sentence — the specific downstream events this would have prevented, with reference to event numbers from the change log]

Implementation detail: [2–3 sentences describing exactly how this would be done in practice — not generic advice]


Step 7 — Persist findings

7a — Write back to the Change Events list

Update the following items — do not modify any other columns. An event may qualify for more than one category; apply all relevant updates:

  • Root cause event: set Is Root Cause = Yes, set Root Cause Statement to the one-sentence root cause statement from 1.1, set Causal Chain Step = 1.
  • Causal chain events (each step from 1.2, in sequence): set Causal Chain Step to the step number (root cause = 1, next = 2, etc.).
  • Intervention window events (each event from Step 3): set Intervention Window = Yes, set Intervention Action to the one-sentence description of the action that was available at that point.
  • Early warning signal events (each event from Step 4): set Early Warning Signal = Yes, set Detectability to the rating from the signal table (HIGH / MEDIUM / LOW).
7b — Save analysis document to Project Documents library

Save the full analysis (all three sections) as a document to the Project Documents library.

Filename: Root_Cause_Analysis_[YYYY-MM-DD].docx — where the date is the date of the most recent status report in the library.

Document header (before the analysis content):

  • Analysis run: [today's date]
  • Covers documents through: [title and date of the most recent status report in the Project Documents library]
7c — Update SHAREPOINT.md

Add or overwrite the Project Analysis Summary section in SHAREPOINT.md with:

  • Last analysis run: [today's date]
  • Covers documents through: [date of most recent status report]
  • Root cause: Event [#] — [title]
  • Root cause date: [date]
  • Root cause statement: [one sentence]
  • Causal chain: [numbered list, max 8 steps, one sentence each]
  • Failure type: [primary classification]
  • Preventability: [rating 1–5]
  • Recommendation: [one sentence]

After all three steps complete, confirm: "Analysis saved to [filename] in the Project Documents library. Change Events list updated. SHAREPOINT.md updated."


Show full SKILL.md (715 more words)Show less

Output — produce the following in chat


SECTION 1: ROOT CAUSE ANALYSIS REPORT

Begin with the following framing statement, exactly as written:

"Names in this analysis record who held information or decision authority at each point. This analysis identifies process and governance gaps — where controls were needed and not in place."

Then state: "The Change Events list has been updated — root cause event, intervention windows, and early warning signals are now flagged."

Present the analysis in the following order:

Root Cause

State the root cause event number, title, and date. Then the one-sentence root cause statement from Step 1.

Causal Chain

Numbered sequence (max 8 steps): event number, what happened, and whether an intervention window existed at this step. One sentence per step.

Failure Classification

Primary failure type. Preventability rating (1–5) with one-sentence justification.

Recommendation

Structured recommendation as specified in Step 6: what, when, owner, what it changes.

Do not include the counterfactual scoring table, intervention windows table, or early warning signal table here — those appear in full in the Detailed Full Analysis (Section 2).


SECTION 2: THREE SUMMARY LEVELS

Produce all three of the following, clearly labelled:


ULTRA-SHORT SUMMARY

For: executive slide decks, steering committee updates, RAID log entries

Write 4–6 bullet points. Each bullet is one sentence. Cover only: what the root cause was, how long the warning window was open, what failure type this represents, and the single recommendation. A reader should understand the verdict in 20 seconds. No background, no process detail.


GET ME UP TO SPEED

For: a delivery director being briefed, a client asking "what went wrong", a new PM inheriting the engagement

Write 3–5 paragraphs. Chronological. Imagine briefing someone intelligent who knows nothing about this project and has 3 minutes. Cover: what the project was, what the root cause event was and when it happened, what signals appeared and how they were handled, what the causal chain looked like from the outside, and what the recommendation is. Include specific event numbers, dates, and names from the change log. Write in plain English — no jargon, no passive voice.


DETAILED FULL ANALYSIS

For: post-mortem reviews, governance audits, contract disputes, project retrospectives

A structured narrative with one paragraph per step of the analysis. This is the complete record — every finding matters. Include:

  • The full counterfactual scoring table (all candidate events, all three dimensions)
  • The full intervention windows table (all columns from Step 3)
  • The full early warning signal table (all columns from Step 4) with the three summary statistics
  • The failure classification with all secondary dimension ratings and justifications
  • The recommendation with full implementation detail

Do not summarise away detail. This section should be suitable for a formal project review or a legal review of the engagement record.


SECTION 3: ROOT CAUSE INTELLIGENCE DASHBOARD

Produce this section under the heading ## ROOT CAUSE INTELLIGENCE DASHBOARD.

Root Cause Metrics
MetricValueCommentary
Root cause eventEvent # and title
Root cause event date
Root cause event week
Total intervention windows identified
Intervention windows acted onState as "N of N"
Total early warning signals
HIGH-detectability signals not acted onInclude % of HIGH signals
Weeks between root cause and impactThe window that was open
Weeks between first HIGH signal and impactThe earliest point action was available
Failure type
Preventability rating1–5 with one-line note
Detectability rating1–5 with one-line note
Signal Disposition Summary

For each signal in the early warning table, show its disposition: Actioned / Logged but not resolved / Noted informally / No action taken / Not documented.

Present as a horizontal bar or count breakdown:

  • Actioned: N
  • Logged but not resolved: N
  • Noted informally: N
  • No action taken: N
  • Not documented: N
Top 3 Intervention Failures

The three intervention windows where action was most available but not taken, ranked by downstream impact:

  1. [Window description — date — who could have acted — what was the specific action available]
  2. [Window description — date — who could have acted — what was the specific action available]
  3. [Window description — date — who could have acted — what was the specific action available]
Failure Classification Summary

State:

  • Primary failure type
  • Whether this was a systemic or one-off failure (systemic = the same failure pattern is likely in other engagements run the same way; one-off = specific to unusual circumstances)
  • One sentence on what changed in the organisation's delivery approach would prevent this class of failure recurring

© pnp, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in Skills/project-intelligence-root-cause-analysis/project-intelligence-root-cause-analysis of pnp/sharepoint-skills.

Open the folder on GitHubat commit aa9eb14

Compare with similar skills

Project Intelligence Root Cause Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project Intelligence Root Cause Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Intelligence Root Cause Analysis this skillpnp/sharepoint-skills131—~3.5kAutomated safety check: PassMIT
CLI Microsoft365pnp/cli-microsoft365-mcp-server131—~3.5kAutomated safety check: PassMIT
Spfx Releasepnp/docker-spfx134—~572Automated safety check: NotesMIT
CLI Microsoft365 Scriptpnp/cli-microsoft365-mcp-server131—~3.3kAutomated safety check: PassMIT
AirweaveCraftOS-dev/CraftBot392—~1.1kAutomated safety check: PassMIT
Sap Btp Build Work Zone Advancedsecondsky/sap-skills460—~3.3kAutomated safety check: PassGPL-3.0

Similar skills

  • CLI Microsoft365

    pnp/cli-microsoft365-mcp-server

    Use CLI for Microsoft 365 to manage Microsoft 365 tenants from the terminal.

    131 GitHub stars~3.5k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Spfx Release

    pnp/docker-spfx

    Automate SPFx version releases - branch, update files, commit, open PR, then tag after merge

    134 GitHub stars~572 tokensUpdated 3 mo ago
    Documents & OfficeAuto-check: notes
  • CLI Microsoft365 Script

    pnp/cli-microsoft365-mcp-server

    Write PowerShell scripts using CLI for Microsoft 365 commands to automate Microsoft 365 management tasks.

    131 GitHub stars~3.3k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Airweave

    CraftOS-dev/CraftBot

    Context retrieval layer for AI agents across users' applications.

    392 GitHub stars~1.1k tokensUpdated today
    Sales & SupportAuto-check passed
  • Develops and administers SAP Build Work Zone, advanced edition digital workplace solutions.

    460 GitHub stars~3.3k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Msgraph SDK

    github/awesome-copilot

    Official

    Integrate Microsoft Graph SDK into any project — .NET, TypeScript/JavaScript, or Python.

    40k GitHub stars~2.1k tokensUpdated today
    Documents & OfficeAuto-check passed

More from pnp/sharepoint-skills

All 51 skills in this repo
  • Scorecard Matrix

    pnp/sharepoint-skills

    Generates a polished, self-contained HTML heatmap scorecard — a weighted comparison matrix where entities (rows) are scored across dimensions (columns), with computed totals, rank badges, and a…

    131 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Analyze Document Library

    pnp/sharepoint-skills

    Analyze the current SharePoint document library in read-only mode and produce a structured summary of files, folders, file types, recent activity, naming issues, and organization recommendations.

    131 GitHub stars~899 tokensUpdated yesterday
    Auto-check passed
  • Broken Link Auditor

    pnp/sharepoint-skills

    Audits SharePoint pages, news posts, and hyperlink fields for broken or risky links and saves a self-contained HTML link-health report to the site.

    131 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Custom Image Tagger

    pnp/sharepoint-skills

    Analyze selected construction images, create missing object metadata columns, and write concise visual metadata back to SharePoint columns using explicit image-analysis, list-schema, list-update…

    131 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Dossier

    pnp/sharepoint-skills

    Renders a polished, self-contained HTML briefing from any data source — SharePoint lists, uploaded documents, or a verbal description.

    131 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Exec Report

    pnp/sharepoint-skills

    Generates a polished, self-contained HTML executive report or dashboard from any data source — SharePoint lists, CSV exports, or a user description.

    131 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Project Intelligence Root Cause Analysis

What does Project Intelligence Root Cause Analysis do?

Reads the Change Events list and produces a full causal analysis of a project failure — a counterfactual root-cause test, the causal chain, intervention windows, and early-warning signal analysis —…. Project Intelligence Root Cause Analysis is an agent skill from pnp/sharepoint-skills. Reads the Change Events list and produces a full causal analysis of a project failure — a counterfactual root-cause test, the causal chain, intervention windows, and early-warning signal analysis — ending in one actionable recommendation, persisted back to SharePoint.

When should I use Project Intelligence Root Cause Analysis?

Project Intelligence Root Cause Analysis fits situations like: the user asks to find the root cause; run root cause analysis on the project; what went wrong and when did we know; trace the causal chain.

How do I install Project Intelligence Root Cause Analysis in Claude Code?

Run `npx skills add pnp/sharepoint-skills --skill project-intelligence-root-cause-analysis -a claude-code`. Or copy the skill folder (Skills/project-intelligence-root-cause-analysis/project-intelligence-root-cause-analysis in pnp/sharepoint-skills) into .claude/skills/project-intelligence-root-cause-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Project Intelligence Root Cause Analysis in Codex?

Run `npx skills add pnp/sharepoint-skills --skill project-intelligence-root-cause-analysis -a codex`. Or copy the skill folder (Skills/project-intelligence-root-cause-analysis/project-intelligence-root-cause-analysis in pnp/sharepoint-skills) into .agents/skills/project-intelligence-root-cause-analysis in your project. Codex loads it when a task matches its description.

Can I use Project Intelligence Root Cause Analysis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pnp/sharepoint-skills --skill project-intelligence-root-cause-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-intelligence-root-cause-analysis, .gemini/skills/project-intelligence-root-cause-analysis, .github/skills/project-intelligence-root-cause-analysis and .opencode/skills/project-intelligence-root-cause-analysis in your project.

What does Project Intelligence Root Cause Analysis need to run?

SKILL.md names no scripts, command-line tools or credentials: Project Intelligence Root Cause Analysis is instructions for the agent only.

Does Project Intelligence Root Cause Analysis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Project Intelligence Root Cause Analysis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Project Intelligence Root Cause Analysis use?

Project Intelligence Root Cause Analysis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Intelligence Root Cause Analysis use?

About 3.5k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Project Intelligence Root Cause Analysis?

Skills that share tags, products or a category with Project Intelligence Root Cause Analysis: CLI Microsoft365 (pnp/cli-microsoft365-mcp-server, 131 stars), Spfx Release (pnp/docker-spfx, 134 stars), CLI Microsoft365 Script (pnp/cli-microsoft365-mcp-server, 131 stars) and Airweave (CraftOS-dev/CraftBot, 392 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Intelligence Root Cause Analysis?

pnp (a GitHub organization) maintains it in pnp/sharepoint-skills, which has 131 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 6, 2026.

Source: pnp/sharepoint-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.