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を活用した事例を探して".

3installs

Sourcehihigash/ms-customer-stories-skill

Added on2026-02-20

NPX Install

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

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:

uv
is available and
.venv/
exists: Use
```
uv run python <script>
```
Virtual environment (
.venv/
) exists without
uv
: Activate it or use
```
.venv/Scripts/python <script>
```
(Windows) /
```
.venv/bin/python <script>
```
(macOS/Linux)
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

Locate the directory containing this SKILL.md to determine script paths (
```
<skill_dir>
```
)
Determine the Python execution command (
```
{python}
```
) as described above
Analyze the user's request to determine appropriate filters
Run
```
{python} <skill_dir>/scripts/search_stories.py
```
with selected filters to find matching stories
Review results and optionally run
```
{python} <skill_dir>/scripts/fetch_story.py
```
on specific stories for full details
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 mentions	Filter 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: