| name | straymark-mcard |
| description | Create a Model/System Card (MCARD) document through an interactive step-by-step flow. Guides the user through each section with specific questions and example responses. |
StrayMark MCARD Skill
Create AI Model/System Card documentation through an interactive guided flow.
Instructions
When invoked, follow these steps:
1. Check for Parameters
If the user specified a model name (e.g., /straymark-mcard GPT-4o), use it as the model name and proceed to step 2 asking only for the model type.
If no parameter is given, proceed to step 2 asking for both model name and type.
2. Gather Model Identity
Ask the user:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ StrayMark MCARD โ Model/System Card โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ Step 1/7: Model Identity โ
โ โ
โ Please provide the following: โ
โ โ
โ 1. Model name: [e.g., "GPT-4o", "BERT-base-uncased"] โ
โ 2. Model type: โ
โ โข LLM โ Large Language Model โ
โ โข classifier โ Classification model โ
โ โข regressor โ Regression model โ
โ โข generator โ Generative model (image, audio, etc.) โ
โ โข recommender โ Recommendation system โ
โ โข other โ Specify โ
โ 3. Provider: [e.g., "OpenAI", "Google", "Hugging Face"] โ
โ 4. Version: [e.g., "2024-05-13", "v1.0", "gpt-4o-2024-05-13"] โ
โ 5. License: [e.g., "Proprietary", "Apache 2.0", "MIT"] โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Wait for user response before proceeding.
3. Gather Intended Use
Ask the user:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Step 2/7: Intended Use โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ 1. Primary intended uses: โ
โ Example: "Code generation", "Customer support chatbot", โ
โ "Sentiment analysis on product reviews" โ
โ โ
โ 2. Primary intended users: โ
โ Example: "Internal engineering team", "End users via API", โ
โ "Data science team" โ
โ โ
โ 3. Out-of-scope uses (what the model should NOT be used for): โ
โ Example: "Medical diagnosis", "Legal advice", โ
โ "Autonomous decision-making without human review" โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Wait for user response before proceeding.
4. Gather Training Data Details
Ask the user:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Step 3/7: Training Data โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ 1. Dataset name: [e.g., "Common Crawl", "Internal corpus v3"] โ
โ 2. Source: [e.g., "Web scraping", "Licensed data provider"] โ
โ 3. Size: [e.g., "1.5T tokens", "500K samples", "200GB"] โ
โ 4. Collection methodology: โ
โ Example: "Web crawling with quality filters" โ
โ 5. Preprocessing steps: โ
โ Example: "Deduplication, PII removal, language filtering" โ
โ 6. Known limitations in the data: โ
โ Example: "English-centric, underrepresents African languages" โ
โ 7. PII assessment: โ
โ Example: "PII filtered using regex + NER; residual risk low" โ
โ 8. Data license: [e.g., "CC-BY-4.0", "Proprietary"] โ
โ โ
โ Type "unknown" or "N/A" for fields you cannot fill. โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Wait for user response before proceeding.
5. Gather Performance and Evaluation
Ask the user:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Step 4/7: Performance & Evaluation โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ Performance Metrics (provide at least one): โ
โ Format: Metric | Value | Test Dataset | Conditions โ
โ Example: "Accuracy | 92.3% | MMLU | 5-shot" โ
โ "F1 | 0.87 | SQuAD v2 | zero-shot" โ
โ "BLEU | 34.2 | WMT-22 en-de | beam search k=5" โ
โ โ
โ Disaggregated evaluation (optional): โ
โ Format: Subgroup | Metric | Value โ
โ Example: "English | Accuracy | 95.1%" โ
โ "Spanish | Accuracy | 88.4%" โ
โ โ
โ Type "unknown" if metrics are not available. โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Wait for user response before proceeding.
6. Gather Bias, Security, and Ethics
Ask the user:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Step 5/7: Bias, Security & Ethics โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ Bias & Fairness (if evaluated): โ
โ Format: Group | Metric | Performance | Mitigation โ
โ Example: "Female | Toxicity | 0.02 | Content filter applied" โ
โ Type "not evaluated" if no bias analysis was performed. โ
โ โ
โ Security Concerns: โ
โ โข Known vulnerabilities: [None / describe] โ
โ โข Adversarial robustness: [Low / Medium / High] โ
โ โข Prompt injection risk: [Low / Medium / High / N/A] โ
โ โข Data poisoning risk: [Low / Medium / High] โ
โ โข Model extraction risk: [Low / Medium / High] โ
โ โ
โ Ethical Considerations: โ
โ โข Was sensitive data used in training? [Yes / No / Unknown] โ
โ โข Human subjects involved? [Yes / No / Unknown] โ
โ โข Dual-use potential? [Yes / No] โ
โ โข Societal impact notes: [Brief description] โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Wait for user response before proceeding.
7. Gather Environmental Impact
Ask the user:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Step 6/7: Environmental Impact โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ 1. Training energy (kWh): [e.g., "1,287 kWh", "Unknown"] โ
โ 2. CO2 equivalent (tons): [e.g., "0.58 tCO2", "Unknown"] โ
โ 3. Hardware used: [e.g., "8x NVIDIA A100 80GB"] โ
โ 4. Training duration: [e.g., "72 hours", "Unknown"] โ
โ 5. Inference cost: [e.g., "$0.005 per 1K tokens", "Unknown"] โ
โ 6. Region / Grid carbon intensity: [e.g., "US-East", "Unknown"] โ
โ โ
โ Type "unknown" for fields you cannot fill. โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Wait for user response before proceeding.
8. Gather Limitations and Recommendations
Ask the user:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Step 7/7: Limitations & Recommendations โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ Known limitations: โ
โ Example: "Poor performance on low-resource languages", โ
โ "Context window limited to 128K tokens", โ
โ "Hallucination rate ~5% on factual queries" โ
โ โ
โ Known failure modes: โ
โ Example: "Produces incorrect math on multi-step problems", โ
โ "May refuse safe queries due to over-filtering" โ
โ โ
โ Recommendations for deployers: โ
โ Example: "Implement output filtering for PII", โ
โ "Use human-in-the-loop for high-stakes decisions", โ
โ "Monitor for performance drift monthly" โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Wait for user response before proceeding.
9. Determine Regulatory Classifications
Based on the gathered information, determine:
-
EU AI Act risk level: Classify based on intended use:
unacceptable: social scoring, real-time biometric identification
high: employment decisions, credit scoring, law enforcement, education
limited: chatbots, emotion recognition, deepfake generation
minimal: spam filters, game AI, search optimization
not_applicable: no EU deployment planned
-
NIST GenAI risks: Select applicable risks from:
privacy, bias, confabulation, cbrn, dangerous_content, environmental, human_ai_config, information_integrity, information_security, intellectual_property, obscene_content, value_chain
-
Overall risk level: low, medium, high, or critical
10. Check Language Configuration
Read .straymark/config.yml to determine language:
language: en
Use template path based on language:
en (default): .straymark/templates/TEMPLATE-MCARD.md
es: .straymark/templates/i18n/es/TEMPLATE-MCARD.md
11. Generate Document ID
Determine the next sequence number:
date +%Y-%m-%d
ls .straymark/09-ai-models/MCARD-$(date +%Y-%m-%d)-*.md 2>/dev/null | wc -l
ID format: MCARD-YYYY-MM-DD-NNN
12. Confirm Before Creating
Display a summary and ask for confirmation:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ StrayMark MCARD โ Summary โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ Model: [model_name] ([model_type]) โ
โ Provider: [provider] โ Version: [version] โ
โ EU AI Act Risk: [risk classification] โ
โ NIST GenAI Risks: [applicable risks] โ
โ Overall Risk: [risk level] โ
โ โ
โ Proposed filename: โ
โ MCARD-YYYY-MM-DD-NNN-[model-name-slug].md โ
โ โ
โ Location: โ
โ .straymark/09-ai-models/ โ
โ โ
โ Review required: YES โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Confirm creation? [Y/n]:
Wait for user confirmation before proceeding.
13. Load Template and Create Document
- Read the appropriate template (EN or ES based on config)
- Replace placeholders:
YYYY-MM-DD -> Current date
NNN -> Sequence number (001, 002, etc.)
[agent-name] -> your runtime's canonical agent identity (see AGENT-RULES.md ยง1 โ e.g. claude-code-v1.0, gemini-cli-v1.0, codex-cli-v1.0, cursor-v1.0; do not assume Claude)
[Model Name] -> User-provided model name
- Fill in all sections with the gathered information
- Set
review_required: true in the frontmatter
- Save to
.straymark/09-ai-models/MCARD-YYYY-MM-DD-NNN-[model-name-slug].md
14. Report Result
After creation, display:
StrayMark MCARD created:
.straymark/09-ai-models/MCARD-YYYY-MM-DD-NNN-[description].md
Model: [model_name] ([model_type])
Provider: [provider]
Review required: yes
Risk level: [risk_level]
EU AI Act: [classification]
Edge Cases
- No
.straymark/09-ai-models/ directory: Create it before saving
- User provides partial information: Fill known fields, mark unknown fields with
[To be determined]
- User declines confirmation: Acknowledge and exit gracefully
- Third-party model with limited info: Mark unknown sections with
[Information not publicly available] and note in limitations
- No
.straymark/config.yml: Default to English (en)