fair-simulation-packager

HeshamFS

Mis à jour Yesterday

4 vues

Métaaidata

À propos

Cette compétence crée des ensembles reproductibles et conformes aux principes FAIR pour les données de simulation de matériaux en collectant automatiquement les fichiers d'entrée/sortie, les métadonnées de provenance et les identifiants de structure. Elle génère des manifestes avec des empreintes de fichiers, des versions des moteurs de calcul et des métadonnées standardisées pour des plateformes comme NOMAD et Materials Project. Les développeurs doivent l'utiliser avant de publier, archiver ou transférer des résultats de simulation pour garantir la reproductibilité.

Installation rapide

Claude Code

Recommandé

Principal

npx skills add HeshamFS/materials-simulation-skills -a claude-code

Commande PluginAlternatif

/plugin add https://github.com/HeshamFS/materials-simulation-skills

Git CloneAlternatif

git clone https://github.com/HeshamFS/materials-simulation-skills.git ~/.claude/skills/fair-simulation-packager

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

FAIR Simulation Packager

Goal

Build a minimal reproducibility manifest for materials simulation results so another person or agent can understand what was run, with which inputs, and how outputs should be interpreted.

Requirements

Python 3.10+
No external dependencies
Works on Linux, macOS, and Windows

Inputs to Gather

Input	Description	Example
Project name	Human-readable bundle name	`al-cu-diffusion-study`
Engine	Simulation code	`LAMMPS`, `VASP`, `MOOSE`
Input files	Files needed to rerun	`in.lammps,data.lmp`
Output files	Files needed to verify results	`log.lammps,traj.dump`
Structure ID	Database or local identifier	`mp-149`
Units	Field/unit mapping	`energy=eV,length=angstrom`

Decision Guidance

Always include input files, output files, code version, and units.
Include hashes for every file that exists locally.
Include structure identifiers when using Materials Project, NOMAD, OPTIMADE, CIF, POSCAR, or internal database records.
Record missing files as warnings instead of silently dropping them.

Script Outputs

scripts/fair_packager.py emits:

manifest
file_inventory
missing_files
fair_checks
recommended_next_steps

Workflow

python3 skills/data-management/fair-simulation-packager/scripts/fair_packager.py \
  --project-name al-cu-diffusion \
  --engine LAMMPS \
  --inputs in.lammps,data.lmp \
  --outputs log.lammps,traj.dump \
  --units energy=eV,length=angstrom,time=ps \
  --structure-id local:alcu-cell-001 \
  --json

Use --out manifest.json only when the user wants a manifest file written.

Error Handling

Missing files are reported in missing_files; invalid unit fields or unsafe paths stop with exit code 2.

Limitations

This skill creates a metadata manifest. It does not upload to NOMAD, Materials Project, or an OPTIMADE provider.

Security

File paths are read only for metadata and SHA-256 hashing.
The script rejects control characters and oversized files above 500 MB.
Optional manifest writing is restricted to the requested output path.
The skill uses Bash only to run the bundled script.

References

See references/fair_manifest.md for recommended manifest fields.

Version History

1.0.0: Initial FAIR simulation packaging skill.

Dépôt GitHub

HeshamFS/materials-simulation-skills

Chemin: skills/data-management/fair-simulation-packager

agent-skillsagentscli-toolscomputational-sciencellmmaterials-science

Compétences associées

content-collections

Méta

Cette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.

Voir la compétence

polymarket

Méta

Cette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.

Voir la compétence

creating-opencode-plugins

Méta

Cette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.

Voir la compétence

sglang

Méta

SGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.

Voir la compétence