Agent skill

Roadmap Timeline

by pnp in pnp/sharepoint-skills

Generates a polished, self-contained HTML roadmap or milestone timeline from any project data — SharePoint lists, pasted tables, or a verbal description.

MITAuto-check passedProduct & Project Management

Install Roadmap Timeline

skills CLI
$ npx skills add pnp/sharepoint-skills --skill roadmap-timeline -a claude-code

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

GitHub CLI
$ gh skill install pnp/sharepoint-skills roadmap-timeline --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/roadmap-timeline/roadmap-timeline .claude/skills/roadmap-timeline && 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
roadmap-timeline
GitHub stars
131
Token cost
~2.2k tokens
SKILL.md length
1,054 words
Files
4 (incl. references, assets)
Skills in repo
51
Repo updated
First seen
Licence
MIT

At a glance

Generates a polished, self-contained HTML roadmap or milestone timeline from any project data — SharePoint lists, pasted tables, or a verbal description.

  • Works in 5 steps: Determine the Data Source → Interview the User → Choose the Rendering Mode → …
  • Asked to build a project roadmap
  • SKILL.md covers Step 1: Determine the Data…, Step 2: Interview the User, Step 3: Choose the Rendering… and Step 4: Build and Validate the…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Roadmap Timeline is an agent skill from pnp/sharepoint-skills. Generates a polished, self-contained HTML roadmap or milestone timeline from any project data — SharePoint lists, pasted tables, or a verbal description. Use when asked to build a project roadmap, product roadmap, migration timeline, release plan, onboarding sequence, run-of-show, phase plan, or any visual schedule showing items over time. Interviews the user if data is incomplete, constructs a validated JSON document, then renders it into a single sandbox-safe HTML file. Chooses between two layouts…

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files and assets (for example `references/components.md` and `references/design-system.md`).

It sits in Product & Project Management, covering Project management, Product roadmapping 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

  • Asked to build a project roadmap
  • Product roadmap
  • Migration timeline
  • Onboarding sequence

Example prompts

  • “Use the roadmap-timeline skill to generate a polished, self-contained HTML roadmap or milestone timeline from any project data — SharePoint lists…”
  • “/roadmap-timeline”

Workflow steps

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

  1. Determine the Data Source
  2. Interview the User
  3. Choose the Rendering Mode
  4. Build and Validate the JSON Document
  5. Render the HTML

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

Roadmap Timeline loads about 2.2k tokens when it runs, and up to ~5.7k if it reads all its reference files. Until then it costs about 181 tokens; SKILL.md has 1,054 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~181
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.7k

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,054 words, ~2,190 tokens.

Download SKILL.mdSave it as .claude/skills/roadmap-timeline/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
roadmap-timeline
description
Generates a polished, self-contained HTML roadmap or milestone timeline from any project data — SharePoint lists, pasted tables, or a verbal description. Use when asked to build a project roadmap, product roadmap, migration timeline, release plan, onboarding sequence, run-of-show, phase plan, or any visual schedule showing items over time. Interviews the user if data is incomplete, constructs a validated JSON document, then renders it into a single sandbox-safe HTML file. Chooses between two layouts automatically: horizontal roadmap with swimlanes (for phase-range data) or vertical milestone list (for point-in-time events). No external dependencies — output runs inside a SharePoint sandboxed iframe.
metadata.author
zrosenfield

Roadmap Timeline

Generates a complete, self-contained HTML visualization by (1) interviewing the user or parsing their data, (2) constructing and validating a JSON document, then (3) rendering that JSON into HTML using assets/roadmap-timeline-template.html. The JSON is the authoritative source of truth; the HTML is fully determined by it.


Step 1: Determine the Data Source

Check what the user has already provided before asking anything:

  • SharePoint lists: Call list_items on the relevant lists. Read all needed columns before proceeding.
  • CSV or table pasted in chat: Parse all rows. Do not ask for data you already have.
  • Verbal description only: Proceed to Step 2.

Step 2: Interview the User

If the data or intent is not fully clear, ask these questions in a single message — not one at a time:

  1. Topic: What is this timeline about? (e.g., "Q3 product launch plan," "cloud migration phases," "new employee onboarding")
  2. Date range: What is the overall span? (start and end dates for the full view)
  3. Swimlanes / tracks: Are there parallel workstreams or teams? (e.g., "Engineering," "Product," "Marketing") If yes → roadmap mode. If items are point-in-time events only → milestones mode.
  4. Items: List the phases or milestones with their dates, owners, and status.
  5. Palette: Warm paper (cream/terra-cotta), deep ink (dark/gold), clean white (white/green), or slate (gray/blue)? Default to slate for roadmaps, warm-paper for milestone lists.
  6. Footer: Any footer text (date, project name, audience)?

Confirm your understanding before building the JSON.


Step 3: Choose the Rendering Mode

Roadmap mode — use when items have start and end date ranges (duration blocks):

  • Items span days, weeks, or months
  • Multiple parallel workstreams exist (or a single flat track is still cleaner as roadmap)
  • The user mentions "phases," "sprints," "quarters," "swimlanes," or "gantt"

Milestones mode — use when items are point-in-time events:

  • Items have a single date (no duration)
  • The user mentions "milestones," "deliverables," "checkpoints," "onboarding steps," or "run of show"

When data is mixed (some ranges, some points), use roadmap mode and mark point-in-time items as "milestone": true.


Step 4: Build and Validate the JSON Document

Construct the JSON object. Full schema:

report object
FieldRequiredDescription
titleyesReport title, shown in header strip
subtitlenoSubtitle or context line
date_range_startroadmap onlyISO date string, e.g. "2026-01-01"
date_range_endroadmap onlyISO date string, e.g. "2026-06-30"
paletteyeswarm-paper, deep-ink, clean-white, or slate
footernoFooter text
mode string

"roadmap" or "milestones".

swimlanes array (roadmap mode only)
FieldRequiredDescription
idyesShort identifier, e.g. "eng"
labelyesDisplay name, e.g. "Engineering"
items array
FieldRequiredDescription
idyesUnique short identifier, e.g. "item-1"
titleyesDisplay label for the block or card
swimlane_idroadmap onlyReferences a swimlane id
startyesISO date string
endroadmap modeISO date string (omit for pure milestones mode)
statusyeson-track, at-risk, delayed, complete, or planned
milestonenotrue if this is a point-in-time event within a roadmap
ownernoText name of the owner (no Person column — plain text only)
descriptionnoAdditional detail shown in tooltip (roadmap) or card body (milestones)
dependenciesnoArray of id strings; rendered as a text note, not as arrows
Date-to-Percentage Computation (roadmap mode)

The skill pre-computes all layout positions as percentages. No JavaScript is required for positioning — all values are embedded in the HTML as inline styles.

ValueFormula
total_daysDays between date_range_end and date_range_start (inclusive span)
item_left_pct((item_start − date_range_start) / total_days) × 100
item_width_pct((item_end − item_start) / total_days) × 100
today_left_pct((today − date_range_start) / total_days) × 100

Rules:

  • Clamp all results to 0.00–100.00
  • Round to 2 decimal places
  • Minimum rendered width for any block: 1.50% (so very short items are always visible)
  • If item_end equals item_start, treat the item as a milestone (diamond) regardless of the milestone flag

Today's date is known from the system context. If today falls outside the date range, omit the today-line entirely.

Show full SKILL.md (421 more words)Show less
Validation Checklist

Run every check before rendering. Fix any failure before proceeding.

Document level:

  • mode is "roadmap" or "milestones"
  • report.palette is one of: warm-paper, deep-ink, clean-white, slate
  • items array has at least one entry
  • Roadmap mode: report.date_range_start and report.date_range_end are present and parseable as ISO dates
  • Roadmap mode: date_range_end is after date_range_start
  • Roadmap mode: swimlanes array has at least one entry

Per item:

  • id is unique within the items array
  • title is present and non-empty
  • start is a valid ISO date string
  • Roadmap mode: end is present and not before start
  • status is one of: on-track, at-risk, delayed, complete, planned
  • Roadmap mode: swimlane_id references a valid swimlane id
  • dependencies entries (if present) each reference a valid item id
  • item_left_pct + item_width_pct does not exceed 101 (floating-point tolerance)

Computation check:

  • All percentage values computed and clamped to 0–100
  • Milestone items have item_width_pct = 0 (rendered as diamonds, not blocks)
  • Today-line computed only when today is within the date range

Step 5: Render the HTML

Read assets/roadmap-timeline-template.html.

For both modes:

  1. Replace {{REPORT_TITLE}} in <title> with a concise page title.
  2. Replace {{PALETTE_CLASS}} on <body> with palette- + palette name.
  3. Replace {{HEADER}} with the .rpt-header strip (title, subtitle, date range).
  4. Replace {{CONTENT}} with the full rendered visualization (roadmap or milestones).
  5. Replace {{FOOTER}} with footer text (or empty string).
  6. Replace {{INLINE_SCRIPT}} with any enhancement JS (tooltip hover, palette switcher if needed).

See references/components.md for the exact HTML structure of each mode.

Roadmap Mode Rendering

Generate the month-marker ruler, then one .swimlane row per swimlane entry. Within each row:

  • Render phase blocks as <div class="phase-block status-{status}"> with inline left and width percentage styles.
  • Render milestone items as <div class="milestone-diamond status-{status}"> with inline left percentage style.
  • Render the today-line as <div class="today-line"> with inline left percentage style (omit if today is out of range).
Milestones Mode Rendering

Group items by phase (if phases are named in description or a group field is provided). For each item render a .milestone-card with a date badge, status dot, title, owner, and description.


Hard Constraints

  • No external URLs, CDN links, or web fonts in the output HTML.
  • No <script src> tags. All JavaScript must be inline.
  • All data values must be pre-rendered into the HTML — the page must be fully correct with JavaScript disabled. JS adds tooltips and animations but must never be required for correctness.
  • Do not generate Python, PowerShell, or any other scripts — output is always the HTML file.
  • Do not render until the validation checklist passes.
  • Owner fields must be plain text — no Person column types.

© 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

SKILL.md and 3 other files (references, assets) in Skills/roadmap-timeline/roadmap-timeline of pnp/sharepoint-skills.

  • SKILL.md
  • assets/roadmap-timeline-template.html
  • references/components.md
  • references/design-system.md

Open the folder on GitHubat commit aa9eb14

Compare with similar skills

Roadmap Timeline 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.

Roadmap Timeline compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Roadmap Timeline this skillpnp/sharepoint-skills131—~2.2kAutomated safety check: PassMIT
App Spec Packagerinstructa/agent-skills139—~1.5kAutomated safety check: PassNone
Verification Gatesrohitg00/skillkit1.5k—~1.7kAutomated safety check: PassApache-2.0
Pm Roadmapserejaris/personal-corp-os229—~2kAutomated safety check: PassMIT
Product Roadmaptikalk/adlc-team-skills141—~3.1kAutomated safety check: PassMIT
Sealeap Amazon New Product Launch Planxjli360/sealeap-amazon-skills240—~548Automated safety check: PassMIT

Similar skills

  • App Spec Packager

    instructa/agent-skills

    A skill your agent uses when the user wants to turn an application, product, startup idea, SaaS, mobile app, web app, API, AI product, or internal tool into a production-ready Markdown specification…

    139 GitHub stars~1.5k tokensUpdated 10 days ago
    Product & Project ManagementAuto-check passed
  • Verification Gates

    rohitg00/skillkit

    Creates explicit validation checkpoints (verification gates) between project phases to catch errors early and ensure quality before proceeding.

    1.5k GitHub stars~1.7k tokensUpdated 4 mo ago
    Product & Project ManagementAuto-check passed
  • Pm Roadmap

    serejaris/personal-corp-os

    Сводит статус итерации, оценивает прогресс milestones, фиксирует изменения приоритетов, отслеживает зависимости и выдаёт roadmap в формате Now/Next/Later с атрибуцией задержек по 5 причинам, health…

    229 GitHub stars~2k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Product Roadmap

    tikalk/adlc-team-skills

    A skill your agent uses when doing weekly progress checks or milestone validation — tracks decision, execution, evidence, and gate states across four layers of truth.

    141 GitHub stars~3.1k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • Sealeap Amazon New Product Launch Plan

    xjli360/sealeap-amazon-skills

    Create a quantified Amazon new-product launch plan by translating a sales target into comparable-product benchmarks, keyword economics, budget scenarios, milestones, and stop-loss rules.

    240 GitHub stars~548 tokensUpdated 10 days ago
    Product & Project ManagementAuto-check passed
  • Run a time-boxed first-order sprint that sequences business registration, relaxed-criteria product screening, a small stock-item test order, seller account creation, listing build, inbound shipment…

    240 GitHub stars~857 tokensUpdated 10 days ago
    Product & Project ManagementAuto-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 2 days ago
    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 2 days ago
    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 2 days ago
    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 2 days ago
    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 2 days ago
    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 2 days ago
    Auto-check passed

Questions about Roadmap Timeline

What does Roadmap Timeline do?

Generates a polished, self-contained HTML roadmap or milestone timeline from any project data — SharePoint lists, pasted tables, or a verbal description. Roadmap Timeline is an agent skill from pnp/sharepoint-skills. Generates a polished, self-contained HTML roadmap or milestone timeline from any project data — SharePoint lists, pasted tables, or a verbal description.

When should I use Roadmap Timeline?

Roadmap Timeline fits situations like: asked to build a project roadmap; product roadmap; migration timeline; onboarding sequence.

How do I install Roadmap Timeline in Claude Code?

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

How do I install Roadmap Timeline in Codex?

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

Can I use Roadmap Timeline 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 roadmap-timeline -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/roadmap-timeline, .gemini/skills/roadmap-timeline, .github/skills/roadmap-timeline and .opencode/skills/roadmap-timeline in your project.

What does Roadmap Timeline need to run?

SKILL.md names no scripts, command-line tools or credentials: Roadmap Timeline is instructions for the agent only.

Does Roadmap Timeline 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 Roadmap Timeline 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 Roadmap Timeline use?

Roadmap Timeline 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 Roadmap Timeline use?

About 2.2k tokens (SKILL.md is roughly 8.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.5k tokens, read only when the agent opens those files.

What are the alternatives to Roadmap Timeline?

Skills that share tags, products or a category with Roadmap Timeline: App Spec Packager (instructa/agent-skills, 139 stars), Verification Gates (rohitg00/skillkit, 1.5k stars), Pm Roadmap (serejaris/personal-corp-os, 229 stars) and Product Roadmap (tikalk/adlc-team-skills, 141 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Roadmap Timeline?

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.