ms-customer-stories

Original：🇺🇸 English
Translated
2 scriptsChecked / no sensitive code detected

Search and retrieve Microsoft Customer Stories from the official Microsoft Customer Stories site (https://www.microsoft.com/en-us/customers/search). Use when the user asks to find customer case studies, success stories, or reference examples of Microsoft technology adoption. Supports filtering by product (Azure, M365, Dynamics 365, etc.), region/country, industry, business need, organization size, and keyword search. Can also fetch individual story details. Typical triggers include questions like "Find customer stories about Azure OpenAI in Japan", "Show me healthcare companies using Microsoft 365 Copilot", or "日本の製造業でAIを活用した事例を探して".

7installs
Sourcehihigash/ms-customer-stories-skill
Added on

NPX Install

npx skill4agent add hihigash/ms-customer-stories-skill ms-customer-stories

Tags

Translated version includes tags in frontmatter
microsoft-customer-storiescase-searchpython-scriptsfilter-parametersapi-utilization

SKILL.md Content

View Translation Comparison →

Microsoft Customer Stories

Overview

Search and retrieve customer stories from Microsoft's official Customer Stories site via its internal API.

Important: Script Location

The 
scripts/
directory and 
references/
directory are located in the same directory as this SKILL.md file. Before running any commands, locate the directory where this SKILL.md resides and use it as the base path for all script references below.
For example, if this SKILL.md is at 
<skill_dir>/SKILL.md
, then:
  • Search script: 
    <skill_dir>/scripts/search_stories.py
  • Fetch script: 
    <skill_dir>/scripts/fetch_story.py
  • Filter reference: 
    <skill_dir>/references/filters.md

Important: Python Execution

Before running scripts, determine the correct way to invoke Python in the current project. Check in this order:
  1. uv
    is available and 
    .venv/
    exists    : Use 
    uv run python <script>
  2. Virtual environment (
    .venv/
    ) exists without 
    uv
    : Activate it or use 
    .venv/Scripts/python <script>
    (Windows) / 
    .venv/bin/python <script>
    (macOS/Linux)
  3. System Python: Use 
    python <script>
    or 
    python3 <script>
Use the detected Python command (referred to as 
{python}
below) for all script executions.

Prerequisites

Install the 
requests
package in the Python environment. Choose the method that matches your setup:
  • uv: 
    uv pip install requests
  • pip (venv): 
    pip install requests
    (after activating the virtual environment)
  • pip (system): 
    pip install requests
    or 
    pip3 install requests

Workflow

  1. Locate the directory containing this SKILL.md to determine script paths (
    <skill_dir>
    )
  2. Determine the Python execution command (
    {python}
    ) as described above
  3. Analyze the user's request to determine appropriate filters
  4. Run 
    {python} <skill_dir>/scripts/search_stories.py
    with selected filters to find matching stories
  5. Review results and optionally run 
    {python} <skill_dir>/scripts/fetch_story.py
    on specific stories for full details
  6. Summarize findings for the user

Step 1: Map User Request to Filters

Translate the user's natural language request into API filter parameters. Consult 
<skill_dir>/references/filters.md
for the complete list of available filter values.
Mapping guidelines:
User mentionsFilter to use
Country/region names (Japan, US, etc.)
--region
(e.g., 
asia/japan
)
Product names (Azure, Teams, etc.)
--products
(e.g., 
azure/azure-openai
)
Industry terms (healthcare, finance, etc.)
--industry
(e.g., 
healthcare
)
Business concepts (AI, automation, etc.)
--business-need
(e.g., 
artificial-intelligence
)
Company size (SMB, enterprise, etc.)
--org-size
(e.g., 
50-999-employees
)
Specific technology terms (RAG, etc.)
--query
(free text search)
Common mappings:
  • "中小企業" / "SMB" → 
    --org-size 50-999-employees
    or 
    --org-size 1-49-employees
  • "大企業" / "Enterprise" → 
    --org-size 10000-employees
  • "RAG" / "検索拡張生成" → 
    --query RAG
    + 
    --products azure/azure-openai
  • "日本" → 
    --region asia/japan

Step 2: Search Stories

Run the search script:
bash
{python} <skill_dir>/scripts/search_stories.py --products azure/azure-openai --region asia/japan --query "RAG" --top 10
Arguments:
  • --query
    / 
    -q
    : Free text search
  • --products
    / 
    -p
    : Product filter (e.g., 
    azure/azure-openai
    , 
    azure/azure-ai-search
    )
  • --region
    / 
    -r
    : Region filter (e.g., 
    asia/japan
    , 
    europe/germany
    )
  • --industry
    / 
    -i
    : Industry filter (e.g., 
    healthcare
    , 
    manufacturing
    )
  • --business-need
    / 
    -b
    : Business need (e.g., 
    artificial-intelligence
    )
  • --org-size
    / 
    -o
    : Organization size (e.g., 
    50-999-employees
    )
  • --service
    / 
    -s
    : Service filter (e.g., 
    fasttrack
    )
  • --includes
    : Stories that include (e.g., 
    videos,partners
    )
  • --top
    / 
    -t
    : Number of results (default: 12)
  • --skip
    : Pagination offset
Output is JSON with 
totalCount
, 
hasMorePages
, and 
stories
array.

Step 3: Fetch Story Details

For interesting stories, fetch the full content:
bash
{python} <skill_dir>/scripts/fetch_story.py 25666-softbank-corp-azure-ai-foundry
Accepts a story slug or full URL. Returns JSON with 
title
, 
description
, 
content
.

Output Format

Always respond in the same language the user used. If the user asks in Japanese, reply in Japanese. If in English, reply in English.
Present results to the user in this format:
## Search Results: {totalCount} stories

### 1. {title}
- **Industry**: {industry}
- **URL**: {url}
- **Summary**: {summary from content}

### 2. {title}
...
When the user asks for details on a specific story, provide a more detailed summary of the story content including key challenges, solutions, and outcomes.