gsd-import

Import external plan files into GSD PLAN.md with conflict detection against PROJECT.md.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-import-trucol270
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-import
Source: https://github.com/TruCol270/salty-pickle/tree/main/.claude-skills/gsd-import
Command: npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-import-trucol270

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ingest external planning artifacts into the GSD system while enforcing alignment with existing PROJECT.md decisions to prevent unapproved changes.

Core Features & Use Cases

  • Import external plan files from a specified path and convert them into the GSD format
  • Detect conflicts against PROJECT.md decisions and surface them for review
  • Write the resolved plan as GSD PLAN.md after conflicts are addressed and approved
  • Validate the resulting plan with gsd-plan-checker to ensure consistency and correctness

Quick Start

Use the gsd-import skill to import an external plan file from a given path and generate a GSD PLAN.md after performing conflict checks.

Frequently Asked Questions about gsd-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I import external project plans and check for conflicts with existing decisions?

To import external project plans and check for conflicts, you ingest the plan file from a specified path, detect conflicts against PROJECT.md decisions, and write the resolved output as a GSD PLAN.md. This prevents unapproved changes from entering your workflow.

What is the best way to convert external planning artifacts into a GSD format?

The best way to convert external planning artifacts into a GSD format is to import the file and validate it against PROJECT.md decisions. This enforces alignment with existing project rules before generating the final GSD PLAN.md output.

How does conflict detection work when importing external plan files?

Conflict detection works by comparing the ingested external plan file against existing PROJECT.md decisions. It surfaces any conflicting changes for review, ensuring that the final GSD PLAN.md only contains approved and consistent project decisions.

Can I validate a generated GSD PLAN.md to ensure consistency and correctness?

Yes, you can validate a generated GSD PLAN.md to ensure consistency by using gsd-plan-checker. After importing an external plan and resolving conflicts, the checker validates the resulting plan file for correctness within the GSD planning system.

What should I do if my imported plan has conflicts against PROJECT.md decisions?

If your imported plan has conflicts against PROJECT.md decisions, you must review and address the surfaced conflicts before proceeding. Once conflicts are resolved and approved, you can safely write the finalized plan as your GSD PLAN.md.

Do I need a specific file path to start importing external plans into the GSD system?

Yes, you need a specific file path to start importing external plans into the GSD system. You provide the source location using the --from flag, which triggers the ingestion, conflict detection, and PLAN.md generation workflow.